Mkc909 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 议题，管理拉取请求。
• PlanetScale 集成：将代理数据、消息和任务存储在可扩展的数据库中。

📦 安装指南

依赖条件

• 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
   

💻 使用示例

开发模式运行

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 PR
• github_review_pr：审查 GitHub PR

🔧 技术细节

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

1. 核心 MCP 服务器
   • 代理注册表
   • 消息总线
   • 任务协调
   • 上下文共享
2. GitHub 集成层
   • 议题管理
   • PR 工作流
   • 项目管理
3. PlanetScale 数据库层
   • 代理数据存储
   • 消息存储
   • 任务数据库

📄 许可证

本项目采用 MIT 许可证。