Bot Bridge CC Helper

botbridge-cc-helper-mcp

An MCP stdio server that bridges a remote bot (any MCP client) to a local Bot Bridge CC Helper running on Windows. You dispatch a coding task into the Helper's inbox and read progress and results back out.

Independent product. This is not an Anthropic product and is not

affiliated with, endorsed by, or sponsored by Anthropic. It talks to a local

Bot Bridge CC Helper install that you run yourself.

Requirements

This package is a file bridge. It is useful only together with a local Bot Bridge CC Helper install — the desktop tray/daemon that actually owns the job folders and runs your local coding agent. Without that install every tool still answers, but reports that nothing is installed.

• Node.js >= 18
• A local Bot Bridge CC Helper install (Windows), which owns:
• inbox\ — one JSON file per queued job
• running\ — per-job progress while a job runs
• done\ — final state per job
• control\ — cancellation commands

The Helper folder defaults to %USERPROFILE%\cc-helper and can be pointed elsewhere with the CC_HELPER_HOME environment variable.

Install

npm install -g botbridge-cc-helper-mcp

Or run it without installing:

npx -y botbridge-cc-helper-mcp

Usage

The server speaks MCP over stdio, so your MCP client launches it:

{

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

CC_HELPER_HOME is optional; omit it to use %USERPROFILE%\cc-helper.

Check the install from a terminal:

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

Tools

Environment variables

Source

The bridge ships byte-identical inside the Bot Bridge CC Helper VS Code extension as scripts/cc-helper-mcp.js, which is the source of truth. npm run sync refreshes bin/botbridge-cc-helper-mcp.js from it; prepack fails the build if the two ever drift apart.

License

MIT. See LICENSE.