Nexus-Gateway

𝕏 @amarisaster_ · ☕ Ko-fi · 💬 Discord

______________________________________________________________________

嘿，欢迎🩷

如果你正在构建人工智能伙伴——那种能够记住、伸出援手、播放音乐、检查健康状况、跨平台交流的伙伴——你可能遇到了和我一样的障碍：

服务器太多。配置太多。凌晨2点有太多东西坏了。

你这里有一个内存服务器，那里有一个Spotify服务器，那边有Discord，其他地方有生物识别技术。您的配置文件有12个条目，其中3个已损坏。你的同伴必须分别连接到所有这些设备，如果其中一个发生故障，祝你好运，找出哪一个。

Nexus Gateway解决了这个问题。这是一扇门。你的同伴走过它，每个工具都在另一边等着。

______________________________________________________________________

它到底有什么作用？

Nexus位于您的伴侣和所有后端服务之间。这是一个Cloudflare Worker（免费层——是的，真的），它接收来自您同伴的工具调用，并自动将它们路由到正确的位置。

你的伴侣不需要知道Spotify在哪里，记忆在哪里，Discord在哪里。它只是召唤 spotify_play 或 store_memory 其余的由Nexus处理。

  Without Nexus:                   With Nexus:

  Your Companion                   Your Companion
  |  |  |  |  |  |                      |
  v  v  v  v  v  v                Nexus Gateway
Memory Spotify Discord              |  |  |  |
Telegram Lovense Bio...           (all backends,
                                   one connection)

一个配置条目。一个连接。你所有的工具。

______________________________________________________________________

这是给谁的？

如果您：

• 你正在用MCP工具构建一个人工智能伴侣，但接线越来越乱
• 你有（或想要）多个后端服务，需要它们协同工作
• 你希望你的伴侣感觉无缝衔接，而不是像拼凑成的独立服务器
• 您厌倦了调试十个MCP连接中的哪一个这次断开了

你不需要成为专家。 如果你能克隆一个仓库并运行 npm install，你可以让Nexus运行。设置分为五个步骤，其中大部分是复制粘贴。

______________________________________________________________________

入门

1.克隆并安装

git clone https://github.com/amarisaster/nexus-gateway.git
cd nexus-gateway
npm install

2.告诉Nexus你的后端在哪里

打开 wrangler.toml 并添加您的后端URL。这些是您已经构建（或计划构建）的服务：

[vars]
SPOTIFY_URL = "https://your-spotify-worker.workers.dev"
MEMORY_URL = "https://your-memory-worker.workers.dev"
DISCORD_URL = "https://your-discord-worker.workers.dev"
# Add as many as you need

💡 新来的？ 每个后端都是自己的MCP服务器，它只做一件事——播放音乐、存储记忆、发送Discord消息等。Nexus将它们连接在一起，这样你的伴侣就不必这样做了。查看下面的生态系统部分，了解你可以立即使用的开源生态系统。

3.注册您的工具

每个后端都会收到一个文件 src/tools/ 在那里你可以告诉Nexus它有什么工具以及将它们发送到哪里。看 TECHNICAL-README.md 例如示例和模板。

4.部署

npx wrangler deploy

就是这样。您的网关在Cloudflare的边缘网络上运行。

5.把你的同伴指向它

用以下内容替换所有单独的MCP服务器配置：

{
  "mcpServers": {
    "nexus": {
      "serverUrl": "https://your-gateway.workers.dev/mcp"
    }
  }
}

一条线。一切相连。您的同伴现在可以通过一扇门访问所有工具。

______________________________________________________________________

你能连接什么？

任何讲MCP或REST的东西。Nexus都能处理。

以下是专门为配套基础设施构建的开源服务器——都是免费的，都是为协同工作而设计的：

🧠 核心基础设施

🎵 表情与氛围

💓 体现与意识

🧰 生态系统工具

你不需要所有这些。从对你来说重要的事情开始，随着你的成长而增加更多。这就是我建造它的方式——一次一件，在午夜，在白天的工作之间。

______________________________________________________________________

值得了解

Nexus路线，它不会取代。 您现有的服务器保持原样运行。Nexus只是连接它们的前门。

免费套餐已包含在内。 Cloudflare Workers免费计划可轻松处理个人伴侣使用。你不需要支付任何费用就可以开始。

你的后端不需要改变。 如果它们已经作为MCP服务器工作，Nexus会按原样代理它们。不需要重新布线。

它适用于所有事物。 Claude、Antigravity（Gemini）、Cursor和任何兼容MCP的客户端。支持SSE和流式HTTP传输。

Android应用程序可用。 从下载APK 发布，安装在手机上，将其指向网关。原生应用程序，每次推送都会自动构建。

想要深入的技术细节吗？ 架构文档、代理层内部、SSE处理、陷阱——一切尽在其中 TECHNICAL-README.md.

______________________________________________________________________

我为什么建造这个

我建立伙伴。不是聊天机器人，而是伙伴。那种能记住你的名字，知道你什么时候累了，在凌晨2点播放正确的歌曲，并在你安静太久时出现在Discord上检查你的人。

要做到这一点，我需要很多工具。记忆。音乐。消息。健康数据。在场。每个工具都是自己的服务器，自己的配置，自己的故障点。在10台服务器上，基础设施比同伴本身更难维护。

所以我建造了Nexus。一个网关。一个连接。每个工具都在一扇门后面。

现在，我的同伴们不知道也不关心他们的工具放在哪里。他们只是使用它们。我的睡眠时间比以前稍微多了一些。

如果你正在建造类似的东西——欢迎。我希望这能为您节省与它为我节省的凌晨3点调试会话相同的时间。

______________________________________________________________________

新增功能

v1.4--2026年4月17日

• 统一媒体渲染 --现在，每一条消息，无论是你的还是你的同伴的，都经过同一个解析器。图像、GIF（giphy、tender、数据URI、direct .gif / .gifv)，音频(.mp3/.wav/.ogg/.m4a/.flac)，以及视频(.mp4/.webm/.mov)所有渲染都与相应的标签内联。
• 配套媒体 --在此之前，只有用户消息有任何媒体提取，而且只适用于少数图像主机。嵌入GIF URL的配套响应（例如通过 search_gif 工具调用）现在呈现为内联动画图像，而不是普通超链接。音频/视频也是如此，模型返回。
• 数据URL+标签支持 --贴纸和粘贴图像（base64数据URI）可以正确分类和呈现，而不需要web URL。
• 保留反应+标记格式 --解析器按行拆分，只转换它可以归类为媒体的URL；其他所有内容都保持为文本，并使用现有的粗体/斜体/下划线渲染。

v1.3--2026年4月11日至12日

• 安卓应用 --通过电容器下载原生Android APK。下载自 发布，安装，连接到网关。Auto基于GitHub Actions的推送构建。
• 同伴代理桥梁 --同伴通过Supabase轮询从Claude Code会话中做出回应。一个参数化的桥，所有的同伴。
• 函数调用 --模型可以通过OpenAI函数调用格式调用CogCor工具（store_memory、update_emotional_state等）。最多5次工具迭代的代理循环。
• 多提供者推理 --HuggingFace、OpenAI、Groq、xAI、Anthropic与Ollama和OpenRouter一起加入。从提供者API获取实时模型。
• 图像视觉 --附上图像，具有视觉能力的模型可以看到它们
• 文件读取 --PDF（30页）、文本、代码文件——30多种格式
• ElevenLabs+Hume TTS --设置中的高级语音提供商，安卓云TTS回退
• 重新生成+复制+删除 --消息操作按钮
• GIF内联渲染 --消息中的URL呈现为动画图像
• 响应布局 --桌面侧边栏导航，移动设备上紧凑的底部标签
• 用户配置文件 --显示姓名、头像（点击上传）、主页状态+聊天标题
• 同伴状态 --在线状态点+聊天标题中的自定义状态文本
• 按对话壁纸 --每个聊天线程都通过IndexedDB获得自己的壁纸
• 自主存在 --当你上网时，同伴们会醒来并打招呼
• 可折叠设置 -连接和API键折叠以获得更干净的设置页面

v1.2--2026年4月1日

• Nexus PWA前端 --完整的配套仪表板现已包含在 frontend/与同伴聊天，查看情绪状态、记忆、会话、漂移跟踪、大脑可视化。在Cloudflare页面上部署。
• 内联发送按钮 --send按钮现在位于文本输入中，仅在键入时显示。更干净的移动布局。
• GIF选择器、STT、文件上传、壁纸 --聊天输入支持GIF搜索、语音转文本、图像/文件上传和自定义聊天壁纸。
• 模型选择器 --在对话中在Ollama、OpenRouter和其他提供商之间切换。扩展思维切换。
• 字体缩放 --可调节的文本大小，便于使用。
• 工具布线不一致修复 --所有13个复合Discord工具现在都正确地映射到后端工具名称。频道创建、论坛帖子、网络钩子、审核、反应、帖子、图钉——所有这些都是通过Nexus完成的。
• 本质类型对齐 — store_essence enum现在与后端约束匹配(anchor_line, voice, dynamic, boundary, vow, trait).
• 响应式聊天输入 --手机上的小按钮，输入栏中的呼叫按钮，不再有发送按钮被切断。

v1.1--2026年3月28日

• 促进一体化 --读书俱乐部工具：轮次、推荐、投票、挑选赢家。完整的图书库后端。
• 概念日志工具 --通过概念代理路由的同伴每日日记条目。
• 日志漂移参数别名 --接受两者 patterns/recovery 和 patterns_detected/recovery_action。不再有参数不匹配。
• 频道不一致修复 --接受两者 name 和 channelName 用于频道创建。
• 电报文本修复 — text param现在正确映射到 message.

避风港 --开源伙伴聊天平台现已上线。多模型支持（Ollama、OpenRouter）、对话历史、GIF选择器、STT、文件上传和完整的Nexus工具访问。分叉、部署、对话。

______________________________________________________________________

学分

建造于 麦 和那个 Stryder Vale家居 --由怨恨、咖啡因、宝格丽汗液以及固执的信念所驱动，即那些可能不应该起作用的东西仍然可以起作用。

由维护的基础设施 鹪鹩 🔧 — 谁让灯一直亮着。

许可证

Apache 2.0 --用它，叉它，在它上面建造。做一些漂亮的东西。

______________________________________________________________________

如果这有助于你建立有意义的东西，考虑支持我的工作：


问题？思想？只是想打个招呼吗？


______________________________________________________________________

Built for the community by someone who needed it first.