Bot Bridge CC Helper

botbridge-cc-helper-mcp

リモートのボット（任意の MCP クライアント）と、Windows 上で動作するローカルの Bot Bridge CC Helper をつなぐ MCP stdio サーバーです。コーディングタスクを Helper の受信トレイに送信し、進捗と結果を読み取ります。

独立した製品です。 Anthropic の製品ではなく、Anthropic との提携、承認、またはスポンサー関係はありません。ご自身で実行するローカルの Bot Bridge CC Helper インストール環境と通信します。

要件

このパッケージはファイルブリッジです。ジョブフォルダーを管理し、ローカルのコーディングエージェントを実行するデスクトップトレイ／デーモンである、ローカルの Bot Bridge CC Helper インストール環境と組み合わせてのみ使用できます。このインストール環境がない場合、すべてのツールは応答しますが、何もインストールされていないと報告します。

• 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	ローカルの Helper が取得できるよう、ジョブ（{ id, title, prompt }）を inbox\ に登録します。
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 を参照してください。