Bot Bridge CC Helper

botbridge-cc-helper-mcp

一个 MCP stdio 服务，可将远程机器人（任何 MCP 客户端）连接到在 Windows 上运行的本地 Bot Bridge CC Helper。你可以将编码任务派发到 Helper 的收件箱，并读取进度和结果。

独立产品。 这不是 Anthropic 的产品，也不隶属于 Anthropic，未获其认可或赞助。它会连接到你自行运行的本地 Bot Bridge CC Helper 安装。

要求

此软件包是一个文件桥接工具。它仅在搭配本地 Bot Bridge CC Helper 安装时有用——该桌面托盘应用／守护进程实际管理任务文件夹并运行你的本地编码 Agent。若未安装该程序，所有工具仍会响应，但会报告未检测到安装。

• Node.js >= 18
• 本地 Bot Bridge CC Helper 安装（Windows），由它管理以下目录：
  • inbox\ — 每个排队的任务对应一个 JSON 文件
  • running\ — 任务运行期间的进度
  • done\ — 每个任务的最终状态
  • control\ — 取消命令

Helper 文件夹默认为 %USERPROFILE%\cc-helper，也可以通过 CC_HELPER_HOME 环境变量指定其他位置。

安装

npm install -g botbridge-cc-helper-mcp

或者无需安装即可运行：

npx -y botbridge-cc-helper-mcp

用法

此服务通过 stdio 使用 MCP 通信，因此由你的 MCP 客户端启动：

{
  "mcpServers": {
    "cc-helper": {
      "command": "npx",
      "args": ["-y", "botbridge-cc-helper-mcp"],
      "env": {
        "CC_HELPER_HOME": "C:\\Users\\you\\cc-helper"
      }
    }
  }
}

CC_HELPER_HOME 是可选的；省略后将使用 %USERPROFILE%\cc-helper。

在终端中检查安装状态：

npx -y botbridge-cc-helper-mcp --selftest

工具

工具	功能
cc_helper_status	报告本地 Helper 是否已安装，以及其文件夹的位置。
cc_helper_dispatch	将任务（{ id, title, prompt }）排入 inbox\，供本地 Helper 接收。
cc_helper_task_status	从 running\ / done\ 读取单个任务的状态。
cc_helper_list_tasks	列出排队中、运行中和已完成的任务。
cc_helper_stop	写入 stop 控制命令以取消正在运行的任务。

环境变量

变量	默认值	含义
CC_HELPER_HOME	Windows 上为 %USERPROFILE%\cc-helper，其他系统上为 ~/cc-helper	桥接工具读写任务文件的文件夹。

源码

此桥接工具以字节完全相同的形式包含在 Bot Bridge CC Helper VS Code 扩展中，路径为 scripts/cc-helper-mcp.js，该文件是唯一可信的源码。 npm run sync 会据此刷新 bin/botbridge-cc-helper-mcp.js；如果两者发生差异，prepack 会导致构建失败。

许可证

MIT。参见 LICENSE。