CrossAgentMCP — A2A 풀 MCP

A2A.md 비전의 최소 구현체: A2A 풀 MCP로,

1. 어떤 에이전트든 공유 풀에 등록할 수 있고,

2. 어떤 에이전트든 멀티 에이전트 세션에 바인딩할 수 있으며,

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은 writer, critic, lead 세 에이전트에게 demo/output/design.md (URL 단축기 설계)를 세 명 모두가 만족을 선언할 때까지 공동 작성하도록 요청합니다.

참고 사항

• .mcp.json 파일은 저장소 경로 D:/GitRepo-AI/CrossAgentMCP를 하드코딩합니다 (claude-a2a 참조와 일치). 저장소를 이동하는 경우 업데이트하십시오.

• 풀 및 에이전트 서버는 상태를 메모리에 유지합니다. 재시작 시 초기화됩니다.