AIPI Bridge MCP

基于 SSE 传输的 MCP 服务器，将 Bot Army 的一个精选子集暴露给仅支持 SSE 的外部 MCP 客户端——特别是 AIPI 的“Custom MCPs”技能配置，该配置将 SSE 记录为当前唯一支持的格式。

刻意保持狭窄，而非通用的 bridge.* 透传：此服务器旨在可从第三方供应商的云（通过 ngrok）访问，而非受信任的本地开发会话，因此它只暴露三个工具，而不是让调用方调用任意的 bridge 主题。对于希望获得完整功能（任意 bridge.* 主题、NATS observe、注册表查询）的本地/受信任 MCP 客户端，请改用 tools/nats-gateway-mcp——stdio 传输，通用 bridge_request 工具。

工具

刻意不暴露： bridge.task.update（误听的语音命令可能在没有确认界面的情况下静默修改现有任务的字段——如果以后需要，将其限定为仅 status→completed，即复用 gtd_task_complete 的形状，而非开放式的字段更新）以及 bridge.project.*（截至 2026-08-15，bridge.project.list 是已知有问题的 responder——尽管任务带有 project_ids，仍返回空）。

Related MCP server: Hermes MCP Bridge

设置

1. 构建（从仓库根目录或本目录）：

   cd tools/aipi-bridge-mcp && npm install && npm run build

2. 运行

   NATS_URL=nats://localhost:4222 \
   AIPI_BRIDGE_MCP_PORT=39895 \
   AIPI_BRIDGE_MCP_TOKEN=<pick-a-token> \
   npm start

   • 在外部隧道化之前，必须设置 AIPI_BRIDGE_MCP_TOKEN——否则 SSE 端点未认证。如果未设置，服务器会在启动时记录警告。

   • SSE 端点：GET /sse（需要 Authorization: Bearer <token>），消息端点：POST /messages?sessionId=...，健康检查：GET /health（无需认证）。

3. 暴露它

   与本仓库中其他所有外部可访问内容相同的模式：通过 air.ngrok 进行隧道（预留端口标签，例如 surface-aipi-mcp），将 AIPI 的 Custom MCP 配置指向生成的 HTTPS URL + /sse，并在其 SSE MCP 配置暴露的任何认证字段中放入 bearer token。

要求

• Node.js 18+

• NATS 服务器可通过 NATS_URL 访问——使用生产环境（nats://localhost:4222）获取真实的 bridge 响应；bridge.chat / bridge.task.* 仅在生产集群上有 responder，开发环境（4223）没有。

开发

• npm run build — 将 TypeScript 编译到 dist/

• npm run dev — 使用 tsx 运行（无需构建）以快速迭代

• 已针对开发 NATS（4223）使用一次性 MCP 客户端进行端到端验证：SSE 握手、tools/list 和 tools/call 均正确往返；工具调用正确报告失败（NATS 503 no responders），而非伪造成功，因为开发集群上没有监听 bridge.chat / bridge.task.list。完整的成功路径验证需要针对生产 NATS 运行。