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 許可證。