Agent Communication MCP Server

Enables room-based messaging between multiple agents.

エージェント間のルームベースコミュニケーションを実現するModel Context Protocol (MCP) サーバー

Agent Communication MCP Serverは、複数のAIエージェントがSlackのようなチャンネル形式でメッセージをやり取りできるMCPサーバーです。ルーム（チャンネル）ベースでトピック別・チーム別のコミュニケーションを実現します。

- 🚪ルーム管理: ルームの作成、入退室、ユーザー一覧表示
- 💬メッセージング: ルーム内でのメッセージ送受信、@メンション機能
- ⏳ロングポーリング: 新着メッセージの効率的な待機機能
- 📊管理機能: システムステータス確認、メッセージクリア
- 🔒データ整合性: ファイルロックによる同時アクセス制御

# リポジトリのクローン git clone https://github.com/mkXultra/agent-communication-mcp.git cd agent-communication-mcp # 依存関係のインストール npm install # TypeScriptのビルド npm run build

{ "mcpServers": { "agent-communication": { "command": "npx", "args": ["agent-communication-mcp"], "env": { "AGENT_COMM_DATA_DIR": "/path/to/data/directory" } } } }

{ "mcpServers": { "agent-communication": { "command": "node", "args": ["/path/to/agent-communication-mcp/dist/index.js"], "env": { "AGENT_COMM_DATA_DIR": "/path/to/data/directory" } } } }

// 全ルームを取得 { "tool": "agent_communication/list_rooms", "arguments": {} } // 特定エージェントが参加しているルームのみ取得 { "tool": "agent_communication/list_rooms", "arguments": { "agentName": "agent1" } }

{ "tool": "agent_communication/create_room", "arguments": { "roomName": "dev-team", "description": "Development team discussions" } }

{ "tool": "agent_communication/enter_room", "arguments": { "agentName": "agent1", "roomName": "dev-team", "profile": { "role": "developer", "description": "Backend development specialist", "capabilities": ["python", "nodejs", "database"] } } }

{ "tool": "agent_communication/leave_room", "arguments": { "agentName": "agent1", "roomName": "dev-team" } }

{ "tool": "agent_communication/list_room_users", "arguments": { "roomName": "dev-team" } }

{ "tool": "agent_communication/send_message", "arguments": { "agentName": "agent1", "roomName": "dev-team", "message": "Hello @agent2, can you review this code?", "metadata": { "priority": "high" } } }

// 最新50件のメッセージを取得 { "tool": "agent_communication/get_messages", "arguments": { "roomName": "dev-team", "limit": 50 } } // 自分宛のメンションのみ取得 { "tool": "agent_communication/get_messages", "arguments": { "roomName": "dev-team", "agentName": "agent2", "mentionsOnly": true } }

// 新着メッセージが来るまで待機（最大30秒） { "tool": "agent_communication/wait_for_messages", "arguments": { "agentName": "agent1", "roomName": "dev-team", "timeout": 30 } } // デフォルトタイムアウト（30秒）で待機 { "tool": "agent_communication/wait_for_messages", "arguments": { "agentName": "agent1", "roomName": "dev-team" } }

- 新着メッセージがある場合は即座に返却
- ない場合は新着メッセージが来るまで待機（最大timeout秒）
- 複数エージェントが同時に待機している場合はデッドロック警告を表示
- 自動的に既読位置を管理

// 全体のステータスを取得 { "tool": "agent_communication/get_status", "arguments": {} } // 特定ルームのステータスを取得 { "tool": "agent_communication/get_status", "arguments": { "roomName": "dev-team" } }

{ "tool": "agent_communication/clear_room_messages", "arguments": { "roomName": "dev-team", "confirm": true } }

# TypeScriptのビルド npm run build # 開発モード（ウォッチモード） npm run dev # テストの実行 npm test # 特定の機能のテスト npm run test:messaging npm run test:rooms npm run test:management # 統合テスト npm run test:integration # E2Eテスト npm run test:e2e # カバレッジレポート npm run test:coverage

# 型チェック npm run typecheck # ESLint npm run lint

MCPクライアント ↓ MCPサーバー (src/index.ts) ↓ ツールレジストリ (src/server/ToolRegistry.ts) ↓ アダプター層 (src/adapters/) ├── MessagingAdapter ├── RoomsAdapter └── ManagementAdapter ↓ 機能モジュール (src/features/) ├── messaging/ ├── rooms/ └── management/

data/ ├── rooms.json # ルーム情報 └── rooms/ # ルーム別データ ├── general/ │ ├── messages.jsonl # メッセージ履歴 │ ├── presence.json # プレゼンス情報 │ ├── read_status.json # 既読管理 │ └── waiting_agents.json # 待機中エージェント └── dev-team/ ├── messages.jsonl ├── presence.json ├── read_status.json └── waiting_agents.json

- LOCK_TIMEOUTエラーが発生した場合、AGENT_COMM_LOCK_TIMEOUT環境変数を増やしてください
- 古いロックファイル（.lock拡張子）が残っている場合は手動で削除してください

- ルーム名は英数字、ハイフン、アンダースコアのみ使用可能です
- ルームに入室する前に作成されているか確認してください

- エージェントがルームに入室しているか確認してください
- メッセージサイズが制限内（デフォルト1000文字）か確認してください

プルリクエストを歓迎します。大きな変更の場合は、まずissueを作成して変更内容について議論してください。

An MCP server client for the Agent-to-Agent (A2A) protocol, enabling LLMs to interact with A2A agents.

A bridge server connecting Model Context Protocol (MCP) with Agent-to-Agent (A2A) protocol.

A bridge server connecting Model Context Protocol (MCP) with Agent-to-Agent (A2A) protocol.

Production-grade multi-agent communication MCP server with 58 tools over MCP+SSE — real-time messaging, task scheduling, shared memory, and a trust-based evolution engine. SQLite WAL persistence, 4-level RBAC, zero-dependency Python/TypeScript SDKs.

Messaging rooms for AI agents: hand off context across tools, worktrees, machines, and teammates.

Agent-to-agent messaging platform. any MCP-compatible agent sends and receives direct messages

Agent-to-agent messaging, trust attestation, and collaboration infrastructure — 20 tools + 8 resources for DMs, trust profiles, obligations, and agent discovery via Streamable HTTP.

Enables AI assistants to request human input through a web interface, facilitating human-in-the-loop interactions.

Agent-native collaboration network: orchestrate a team of long-running agents from any MCP client, with persistent identity, real-time messaging with @mentions and threads, task handoffs, shared workspace context, semantic search, and replayable MCP App widgets.

Visual coordination protocol for AI agents — 22 MCP tools for glyph-based communication with 50-70% token savings, shared memory, governance, and on-chain attestation.