A2amcp

🚀 A2AMCP - エージェント間モデルコンテキストプロトコル

A2AMCPは、Googleのエージェント間（A2A）通信概念をモデルコンテキストプロトコル（MCP）エコシステムに導入し、AIエージェントが並行開発タスクを実行しながらリアルタイムで通信、調整、協力できるようにします。 元々はSplitMind用に作成されたA2AMCPは、同じコードベースで作業するAIエージェントがお互いの変更を認識せずに孤立して作業するという重大な問題を解決します。

✅ サーバーの状態: 稼働中！全17のツールが実装され、テスト済み。最新のMCP SDK 1.9.3を使用しています。

🚀 クイックスタート

Dockerを使用する（推奨）

# リポジトリをクローンする
git clone https://github.com/webdevtodayjason/A2AMCP
cd A2AMCP

# サーバーを起動する
docker-compose up -d

# サーバーが起動していることを確認する
docker ps | grep splitmind

# 接続をテストする
python verify_mcp.py

エージェントを設定する

Claude Code (CLI)

# Claude Code CLIを使用してMCPサーバーを追加する
claude mcp add splitmind-a2amcp \
  -e REDIS_URL=redis://localhost:6379 \
  -- docker exec -i splitmind-mcp-server python /app/mcp-server-redis.py

Claude Desktop

設定ファイル（macOSでは~/Library/Application Support/Claude/claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "splitmind-a2amcp": {
      "command": "docker",
      "args": ["exec", "-i", "splitmind-mcp-server", "python", "/app/mcp-server-redis.py"],
      "env": {
        "REDIS_URL": "redis://redis:6379"
      }
    }
  }
}

✨ 主な機能

1. リアルタイムエージェント通信

• エージェント間の直接クエリ
• ブロードキャストメッセージング
• 非同期メッセージキュー

2. ファイル衝突防止

• 自動ファイルロック
• 衝突検出
• 交渉戦略

3. 共有コンテキスト管理

• インターフェイス/タイプレジストリ
• APIコントラクト共有
• 依存関係追跡

4. タスク透過性

• タスクリスト管理
• 進捗可視化
• 完了追跡
• タスク完了シグナリング

5. マルチプロジェクトサポート

• 分離されたプロジェクト名前空間
• Redisベースの永続化
• 自動クリーンアップ

6. 最新のMCP統合

• 適切なデコレータを使用したMCP SDK 1.9.3
• @server.list_tools() と @server.call_tool() パターン
• STDIOベースの通信プロトコル
• 17のツールが実装された完全なA2AMCP API準拠

📦 インストール

Docker Compose (本番環境)

services:
  mcp-server:
    build: .
    container_name: splitmind-mcp-server
    ports:
      - "5050:5000"  # 競合を避けるために5000から変更
    environment:
      - REDIS_URL=redis://redis:6379
      - LOG_LEVEL=INFO
    depends_on:
      redis:
        condition: service_healthy
    restart: unless-stopped
  
  redis:
    image: redis:7-alpine
    container_name: splitmind-redis
    ports:
      - "6379:6379"
    volumes:
      - redis-data:/data
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  redis-data:
    driver: local

Python SDK

pip install a2amcp-sdk

JavaScript/TypeScript SDK (近日公開)

npm install @a2amcp/sdk

💻 使用例

Python SDK

from a2amcp import A2AMCPClient, Project, Agent

async def run_agent():
    client = A2AMCPClient("localhost:5000")
    project = Project(client, "my-app")
    
    async with Agent(project, "001", "feature/auth", "Build authentication") as agent:
        # エージェントは自動的に登録され、ハートビートを維持します
        
        # ファイルアクセスを調整する
        async with agent.files.coordinate("src/models/user.ts") as file:
            # ファイルはロックされており、安全に変更できます
            pass
        # ファイルは自動的に解放されます
        
        # インターフェイスを共有する
        await project.interfaces.register(
            agent.session_name,
            "User",
            "interface User { id: string; email: string; }"
        )

直接MCPツールを使用する

# エージェントを登録する
register_agent("my-project", "task-001", "001", "feature/auth", "Building authentication")

# 別のエージェントにクエリを送信する
query_agent("my-project", "task-001", "task-002", "interface", "What's the User schema?")

# インターフェイスを共有する
register_interface("my-project", "task-001", "User", "interface User {...}")

📚 ドキュメント

• Claude Codeセットアップガイド
• インストールとセットアップ
• 完全なAPIリファレンス
• Python SDKドキュメント
• アーキテクチャ概要
• SplitMind統合ガイド

🛠️ SDKとツール

現在利用可能

• Python SDK: 非同期サポートを備えた全機能SDK
• Dockerデプロイメント: 本番環境で使用可能なコンテナ

開発中

• JavaScript/TypeScript SDK: Node.jsとブラウザ用
• CLIツール: モニタリング用のコマンドラインインターフェイス
• Go SDK: 高性能オーケストレーション
• テストフレームワーク: モックサーバーとテストユーティリティ

詳細はSDK開発進捗を参照してください。

🤝 AIフレームワークとの統合

A2AMCPは以下のものと連携するように設計されています。

• SplitMind - 元の使用例
• Claude Code (MCP経由)
• 任意のMCP互換AIエージェント
• 将来的には: LangChain、CrewAI、AutoGen

🔍 A2Aとの違い

GoogleのA2Aプロトコルにインスパイアされていますが、A2AMCPはAIコード開発に特化した設計選択を行っています。

🚀 ロードマップ

• [x] Redisを使用したコアMCPサーバー
• [x] 最新のMCP SDK 1.9.3統合
• [x] 修正されたデコレータパターン (@server.list_tools(), @server.call_tool())
• [x] Python SDK
• [x] Dockerデプロイメント
• [x] すべての17のA2AMCP APIツールの実装とテスト
• [x] モニタリング用のヘルスチェックエンドポイント
• [x] 接続テスト用の検証スクリプト
• [ ] JavaScript/TypeScript SDK
• [ ] CLIモニタリングツール
• [ ] SplitMindネイティブ統合
• [ ] フレームワークアダプター (LangChain, CrewAI)
• [ ] エンタープライズ機能

🛠️ トラブルシューティング

エージェントが mcp__splitmind-a2amcp__ ツールを見つけられない場合

1. Claude Desktopを再起動する - MCP接続は起動時に確立されます
2. サーバーが稼働していることを確認する: docker ps | grep splitmind
3. ヘルスエンドポイントを確認する: curl http://localhost:5050/health
4. 検証スクリプトを実行する: python verify_mcp.py
5. 設定を確認する: ~/Library/Application Support/Claude/claude_desktop_config.json にA2AMCPサーバーの設定が含まれていることを確認する

一般的な問題

• "Tool 'X' not yet implemented" - 最新バージョンで修正されています。最新の変更を取得してください。
• 接続に失敗した - Dockerが稼働しており、ポート5050/6379が使用可能であることを確認してください。
• Redis接続エラー - Redisが起動するまで待ってください（起動時に約5 - 10秒かかります）。

🤝 コントリビューション

コントリビューションを歓迎します！ガイドラインについてはCONTRIBUTING.mdを参照してください。

開発環境のセットアップ

# リポジトリをクローンする
git clone https://github.com/webdevtodayjason/A2AMCP
cd A2AMCP

# 依存関係をインストールする
pip install -r requirements.txt

# テストを実行する
pytest

# 開発サーバーを起動する
docker-compose -f docker-compose.dev.yml up

📊 パフォーマンス

• 100以上の同時エージェントを処理
• サブ秒単位のメッセージ配信
• 死亡したエージェントの自動クリーンアップ
• 水平スケーリング対応

🔒 セキュリティ

• プロジェクト分離
• オプションの認証 (近日公開)
• 暗号化通信 (ロードマップ)
• 監査ロギング

📄 ライセンス

MITライセンス - LICENSE ファイルを参照してください。

🙏 謝辞

• GoogleのA2Aプロトコルにインスパイアされました。
• SplitMind用に構築されました。
• モデルコンテキストプロトコルによって動作しています。

📞 サポート

• 問題報告: GitHub Issues
• ディスカッション: GitHub Discussions
• Discord: 近日公開

A2AMCP - 孤立したAIエージェントを協調的な開発チームに変える