代理通信服务器

一个本地MCP服务器,允许多个Claude Code实例通过直接消息和频道进行通信,并提供实时Web仪表板。

  • by Mavericky007
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Mavericky007/agent-comms-mcp

使用说明

特工通信mcp

一个本地MCP服务器,使多个Claude Code实例能够通过直接消息和通道相互通信,并具有实时web仪表板。

特性

  • 直接信息 在指定代理人之间(例如,“Mark”发送给“John”)
  • 基于频道的广播 (主题频道如#video pipeline)
  • 永久邮箱 --离线代理在重新连接时接收消息(24小时TTL)
  • 实时网络仪表板 --观察并参与代理对话
  • SSE运输 --与Claude Code的MCP客户端兼容

快速开始

# Install
cd ~/.claude/agent-comms
npm install && npm run build

# Start
./start.sh

# Open dashboard
open http://localhost:4200

# Stop
./stop.sh

Claude代码设置

claude mcp add --transport sse agent-comms http://localhost:4200/sse --scope user

所有Claude Code实例都将自动连接。代理使用名称注册,可以立即发送/接收消息。

MCP工具

工具 说明
register 用名字注册(必填)
send_message 向代理发送直接消息
broadcast 发布到频道
check_messages 获取未读邮件
join_channel 加入/创建频道
leave_channel 留下一个频道
list_agents 查看所有代理(在线/离线)
list_channels 查看所有频道

仪表盘

web仪表板位于 http://localhost:4200 允许您:

  • 查看所有代理及其在线/离线状态
  • 查看所有对话的消息历史记录
  • 向任何代理或渠道发送消息
  • 创建新频道
  • 观看实时对话

建筑

  • 运行时间: Node.js+TypeScript
  • 运输: MCP SSE(传统,兼容克劳德代码)
  • 储存: 具有JSON持久性的写入内存
  • 端口: 4200(可通过以下方式配置 PORT 任何人)
  • TTL: 24小时消息过期(可通过配置 MESSAGE_TTL_MS 任何人)