CrossAgentMCP — A2AプールMCP

A2A.mdビジョンの最小限の実装：A2AプールMCP。ここでは

1. 任意のエージェントが共有プールに登録でき、

2. 任意のエージェントがマルチエージェントセッションにバインドでき、

3. エージェント同士が互いのアクティビティを監視し、ピアが終了した後に批評し、 自己改善し、セッション内のすべてのエージェントが共有目標を満たすまで人間の介入なしに作業を続けます。

アーキテクチャ

3つのプロセスタイプ：

        ┌────────────────── POOL (:9100, FastAPI HTTP JSON-RPC) ──────────────────┐
        │  registry / sessions / activity / critique / goal  (in-memory control   │
        │  plane — does NOT route work messages)                                  │
        └──────────────────────────────────────────────────────────────────────────┘
            ▲ pool JSON-RPC (PoolClient)            ▲ pool JSON-RPC (per-agent bridge)
            │                                       │
      ┌─────┴──────┐    peer A2A (SendMessage/GetTask)   ┌─────┴──────┐
      │ orchestrator│◄──────────────────────────────────►│ agent-N    │ … :9101..9103
      └────────────┘      each agent runs its own         └────────────┘
          headless            v1.0 A2A HTTP server

• プール（crossagent/pool.py）— 中央制御プレーン：レジストリ、セッション、 セッションごとの追記専用アクティビティログ、批評スレッド、エージェントごとの満足度。

• エージェント — それぞれがディレクトリ（agents/<role>/）であり、以下を含む：

  • server.py — v1.0 A2A HTTPサーバー（ピアデータプレーン）；

  • .mcp.json — a2a stdio MCPブリッジ（crossagent/a2a_bridge.py）を登録；

  • CLAUDE.md — ロール＋ターンごとの契約。

• オーケストレーター（crossagent/orchestrator.py）— 時間を進める唯一のコンポーネント： エージェントを登録し、セッションを作成し、各エージェントをラウンドロビンで ヘッドレス実行（claude -p）し、前回のターン以降のアクティビティ/批評の差分を フィードし、すべてのメンバーが満足するまで（またはターン予算/進捗なしガードが作動するまで）続けます。

Related MCP server: kitty-hive

プロトコル

A2A v1.0（PascalCase JSON-RPCメソッド、camelCase JSON、 SCREAMING_SNAKE_CASE 列挙型）に忠実。crossagent/a2a.pyを参照。

セットアップ

uv sync          # Python 3.11+ venv + deps

使用方法

make test        # unit tests (protocol / pool / orchestrator with fake agents)
make smoke       # pool + 2 A2A servers up; scripted round-trip (no real Claude)
make demo        # full headless 3-agent demo (writer / critic / lead) — needs `claude`

デモ目標

demo/goal.jsonは、ライター、批評家、リーダーの3つのエージェントに、 3つすべてが満足を宣言するまでdemo/output/design.md（URL短縮サービスの設計）を 共同作成するよう求めます。

注意事項

• .mcp.jsonファイルはリポジトリパスD:/GitRepo-AI/CrossAgentMCPをハードコードしています（ claude-a2aリファレンスに一致）；リポジトリを移動した場合は更新してください。

• プールとエージェントサーバーは状態をメモリ内に保持します；再起動するとリセットされます。