agent-bridge-mcp

一个MCP服务器和HTTP网关，用于将编码任务分派给 Claude Code、 Codex 和 Antigravity (agy) CLI会话，跟踪这些会话， 并可选择对真实仓库运行实现 → 审查 → 验证循环。

状态：实验性。 最初是个人编排工具， 希望会话路由和证据检查部分对他人有用。 接口将会变化。

功能

• 会话路由 — 按项目和主题启动/恢复 Claude Code / Codex 会话， 使后续提示进入同一上下文。

• 任务跟踪 — 每次分派都成为一个任务，包含状态、输出和退出码。

• 证据检查 — 运行您指定的仓库测试命令，并报告更改是否 实际通过了测试，然后才接受。

• 审查循环 — 依次分派实现代理和审查代理， 达到修订限制，并通过证据检查进行门控。

• 网关 — 通过 HTTP + WebSocket 提供相同功能， 以便远程客户端（例如手机）可以分派工作并流式输出。

安装

npm install -g @yukinuma/agent-bridge-mcp

需要 Node.js 20+，以及您打算使用的任何代理 CLI （claude、codex 和/或 agy）已安装并认证。

关于 antigravity 代理的说明

agy 运行一个内部语言服务器，需要真正的终端。从普通管道启动时， 它在回答之前就关闭了，从调用方来看，这与挂起无法区分。 在 Windows 上，此适配器因此使用 winpty（随 Git for Windows 捆绑） 运行它，并在调用期间保持 stdin 打开。

两个值得注意的后果：

• winpty 在拆卸时因其自身断言而中止，因此其退出码不反映 agy 做了什么。通过 pty 运行时，适配器通过是否收到响应 来判断成功，而不是退出码，并从捕获的输出中过滤掉断言文本。

• 超时时，进程树按 PID 终止。按映像名称终止会杀死您在其他地方 打开的任何交互式 agy，因此故意不这样做。

如果任一二进制文件位于非标准位置，请设置 WINPTY_PATH 或 AGY_PATH。 在非 Windows 平台上，agy 直接启动，未经测试。

用作 MCP 服务器

{
  "mcpServers": {
    "agent-bridge": {
      "command": "agent-bridge-mcp",
      "env": {
        "AGENT_BRIDGE_WORKSPACE": "/path/to/your/projects"
      }
    }
  }
}

暴露的工具：agent_send、agent_status、agent_sessions、agent_cancel。

用作网关

export ABC_AUTH_TOKEN="$(openssl rand -hex 24)"
export AGENT_BRIDGE_WORKSPACE="/path/to/your/projects"
agent-bridge-gateway

如果未设置 ABC_AUTH_TOKEN，网关拒绝启动。没有默认令牌。

端点

/api/dispatch、/api/git/commit-push 和 /api/review-loop 需要明确的 目标 — 要么是 cwd，要么是在工作区内的 project。它们返回 400， 而不是回退到默认目录，并且会拒绝逃逸工作区的 project 值。

安全性

此服务在关闭安全提示的情况下运行编码代理。 这是实现无人值守分派的 必要条件——代理在需要批准时会停止，当无人操作键盘时就会挂起—— 但这意味着任何能访问 API 的人都可以以网关运行用户的身份运行任意代码。

具体来说，CLI 适配器传递：

两者默认都绕过。退出选项是适配器级别的选项；尚未通过 MCP 工具或 REST API 暴露，因此通过 HTTP 时绕过目前是无条件的。

将其视为特权本地守护进程：

• 默认绑定到 127.0.0.1。将 AGENT_BRIDGE_HOST 设置为其他值会向您的网络 暴露任务分派、无沙箱代码执行和 git 推送。

• 认证令牌是一个共享密钥，作为 Bearer 标头或 token 查询参数发送。 查询参数会出现在日志中——尽可能使用标头。泄露该令牌等同于交出 shell。

• 除了工作区路径检查外，项目之间没有沙箱隔离。

• /api/git/commit-push 推送到目标仓库配置的任何远程仓库。 推送前不会再次询问。

不要将其暴露给不受信任的网络，也不要使用比工作所需更多权限的用户运行。

开发

npm install
npm run typecheck
npm run build

许可证

MIT