agent-bridge-mcp

Claude Code、Codex、Antigravity (agy) のCLIセッションにコーディングタスクをディスパッチし、それらのセッションを追跡し、オプションで実際のリポジトリに対して実装 → レビュー → 検証ループを実行するMCPサーバー兼HTTPゲートウェイです。

ステータス: 実験的。 これは個人的なオーケストレーション用の装置として始まったもので、セッションルーティングとエビデンスゲートの部分が他の人の役に立つことを願って公開しています。インターフェースは変更される予定です。

機能

• セッションルーティング — プロジェクトとトピックごとに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に同梱）の下でagyを実行し、呼び出しの間stdinを開いたままにします。

知っておく価値のある2つの結果:

• 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 pushがネットワークに公開されます。

• 認証トークンは単一の共有シークレットで、ベアラーヘッダーまたはtokenクエリパラメータとして送信されます。クエリパラメータはログに残るため、可能な場合はヘッダーを優先してください。そのトークンが漏洩することは、シェルを渡すことと同等です。

• ワークスペースのパスチェック以外に、プロジェクト間のサンドボックス化はありません。

• /api/git/commit-pushは、ターゲットリポジトリに設定されているリモートにプッシュします。プッシュ前に再度確認はしません。

これを信頼できないネットワークに公開しないでください。また、作業に実際に必要な以上のアクセス権を持つユーザーとして実行しないでください。

開発

npm install
npm run typecheck
npm run build

ライセンス

MIT