agent-communication-mcp-server

🚀 跨系统代理通信 MCP 服务器

本 MCP 服务器实现了不同 Roo 模式/角色之间的通信与协作，让它们能跨越多个系统开展合作。它构建了「代理团队」架构，支持专业化的 LLM 代理在任务执行、知识共享和工作调度等方面协同工作。

🚀 快速开始

前提条件

• Node.js 18 或更高版本
• TypeScript 5.3 或更高版本
• GitHub API 授权访问
• PlanetScale 数据库账户

安装步骤

1. 克隆仓库：

git clone https://github.com/mkc909/agent-communication-mcp-server.git
cd agent-communication-mcp-server

2. 安装依赖项：

npm install

3. 创建 .env 文件，添加以下变量：

GITHUB_TOKEN=your_github_token
PLANETSCALE_HOST=your_planetscale_host
PLANETSCALE_USERNAME=your_planetscale_username
PLANETSCALE_PASSWORD=your_planetscale_password

4. 构建项目：

npm run build

5. 启动服务器：

npm start

✨ 主要特性

• 代理注册中心：注册并管理不同 Roo 模式/角色及其能力
• 消息总线：实现代理之间的异步通信
• 任务调度：管理任务分派与进展追踪
• 知识共享：促进代理间的知识移交
• GitHub 集成：创建和跟踪 GitHub 问题，管理_pull request_
• PlanetScale 集成：在可扩展数据库中存储代理数据、消息和任务

🏗️ 架构

跨系统代理通信 MCP 服务器由三个主要组件组成：

1. 核心 MCP 服务器

• 代理注册中心
• 消息总线
• 任务调度
• 知识共享

2. GitHub 集成层

• 问题管理
• Pull Request 工作流
• 项目管理

3. PlanetScale 数据库层

• 代理数据存储
• 消息存储
• 任务数据库

💻 使用示例

开发相关操作

以开发模式运行

npm run dev

执行测试

npm test

代码检查

npm run lint

📚 详细文档

API 端点

代理管理

• register_agent：注册新代理
• update_agent：更新代理信息
• get_agent：获取代理信息
• list_agents：列出所有已注册代理

消息通信

• send_message：向另一个代理发送消息
• get_messages：获取代理的消息
• mark_message_read：标记消息为已读
• delete_message：删除一条消息

任务管理

• create_task：创建新任务
• assign_task：将任务分配给代理
• update_task_status：更新任务状态
• get_task：获取任务细节
• list_tasks：列出所有任务

知识共享

• create_context：创建共享上下文
• update_context：更新共享上下文
• share_context：将上下文共享给代理
• get_context：获取共享上下文
• list_contexts：列出所有共享上下文

GitHub 集成

• github_create_issue：创建 GitHub 问题
• github_comment_issue：在 GitHub 问题上留言
• github_create_pr：创建 GitHub Pull Request
• github_review_pr：审查 GitHub Pull Request

📄 许可证

MIT