AIPI Bridge MCP

SSEトランスポートのMCPサーバーで、SSEのみを話す外部MCPクライアントに対してBot Armyの厳選された一部を公開します — 具体的にはAIPIの「Custom MCPs」スキル設定で、SSEが現在サポートされている唯一の形式であると文書化されています。

意図的に狭い範囲であり、汎用のbridge.*パススルーではありません: これは、信頼されたローカル開発セッションではなく、サードパーティベンダーのクラウド（ngrok経由）から到達可能であることを意図しているため、呼び出し元が任意のブリッジサブジェクトを呼び出せるようにするのではなく、正確に3つのツールを公開します。完全なサーフェス（任意のbridge.*サブジェクト、NATS observe、レジストリクエリ）を必要とするローカル/信頼されたMCPクライアントは、代わりにtools/nats-gateway-mcpを使用してください — stdioトランスポート、汎用のbridge_requestツール。

Tools

意図的に公開しない: bridge.task.update（聞き間違えた音声コマンドが確認画面なしで既存タスクのフィールドを静かに変更する可能性がある — 後で必要になった場合は、status→completedのみに限定し、つまりgtd_task_completeの形状を再利用し、無制限のフィールド更新は避ける）およびbridge.project.*（bridge.project.listは2026-08-15時点で既知の壊れたレスポンダーであり、タスクがproject_idsを持っているにもかかわらず空を返す）。

Related MCP server: Hermes MCP Bridge

Setup

1. ビルド（リポジトリルートまたはこのディレクトリから）：

cd tools/aipi-bridge-mcp && npm install && npm run build

2. 実行

NATS_URL=nats://localhost:4222 \
AIPI_BRIDGE_MCP_PORT=39895 \
AIPI_BRIDGE_MCP_TOKEN=<pick-a-token> \
npm start

• AIPI_BRIDGE_MCP_TOKENは、これを外部にトンネリングする前に必要です — これがないとSSEエンドポイントは認証されません。サーバーは起動時に未設定の場合、警告をログに記録します。

• SSEエンドポイント: GET /sse（Authorization: Bearer <token>が必要）、メッセージエンドポイント: POST /messages?sessionId=...、ヘルスチェック: GET /health（認証なし）。

3. 公開する

   このリポジトリ内の他の外部到達可能なものと同じパターン: air.ngrokを介してトンネリングし（ポートラベル、例: surface-aipi-mcpを予約）、結果のHTTPS URL + /sseをAIPIのCustom MCP設定に指定し、ベアラートークンを彼らのSSE MCP設定が公開する任意の認証フィールドに入れます。

Requirements

• Node.js 18+

• NATS_URLで到達可能なNATSサーバー — 実際のブリッジ応答にはprod（nats://localhost:4222）を使用; bridge.chat / bridge.task.*は本番クラスタにのみレスポンダーがあり、dev（4223）にはありません。

Development

• npm run build — TypeScriptをdist/にコンパイル

• npm run dev — 迅速な反復のためにtsxで実行（ビルドなし）

• 使い捨てのMCPクライアントを使用してdev NATS（4223）に対してエンドツーエンドで検証済み: SSEハンドシェイク、tools/list、tools/callはすべて正しくラウンドトリップします; ツール呼び出しは、devクラスタでbridge.chat / bridge.task.listをリッスンするものがないため、成功を偽造するのではなく、失敗（NATS 503 no responders）を正しく報告します。完全なハッピーパス検証には、prod NATSに対する実行が必要です。