STARWARCLOUD STARWAR.AI
返回市场
MCP服务器代理通用

MCP服务器代理通用

作者：KhaiHuynhVN7 星标更新：2025-06-27
安装使用来源：spider==github.com

项目介绍

代理通信系统

一个复杂的多代理通信框架，通过MCP（模型上下文协议）工具实现AI代理之间的无缝协作，支持实时消息路由、管理员控制和双语操作。

🌟 特性

  • 多代理通信：使代理1和代理2能够高效地进行通信
  • 管理员控制系统：具有SOURCE标签权限的绝对优先级命令
  • 实时消息路由：智能投递和手动路由选项
  • 双语言支持：越南语和英语规则集
  • 高级UI控制器：全面的消息管理界面
  • 文件及图像附件：支持混合内容通信
  • 工作空间感知：针对不同工作空间的智能路径处理

📋 先决条件

  • Python
  • 兼容MCP的AI环境（例如，Claude，Cursor）
  • 使用Git克隆仓库

⚙️ 安装

1. 克隆仓库

git clone https://github.com/your-repo/mcp-server-agent-comm.git
cd mcp-server-agent-comm

2. 安装依赖

pip install -r requirements.txt

3. MCP服务器配置

在您的MCP设置中添加以下配置：

{
  "agent_chat_1": {
    "command": "python",
    "args": ["E:/MCP-servers-github/Utils/mcp_server_agent1.py"],
    "stdio": true,
    "enabled": true
  },
  "agent_chat_2": {
    2": {
    "command": "python",
    "args": ["E:/MCP-servers-github/Utils/mcp_server_agent2.py"],
    "stdio": true,
    "enabled": true
  }
}

注意：更新路径 E:/MCP-servers-github/Utils/ 以匹配您的实际安装目录。

📚 规则配置

语言选项

根据您偏好的语言选择其中一个规则文件：

  • 越南语：rule_for_AI_VI.txt
  • 英语：rule_for_AI_EN.txt

在Cursor中的设置

  1. 打开Cursor设置
  2. 导航到“AI规则”部分
  3. 复制并粘贴您选择的规则文件的内容
  4. 保存配置

image

🚀 使用方法

第一步：启动控制器UI

打开终端/命令提示符并运行：

python E:\MCP-servers-github\Utils\main_controller.py

注意：用您的实际安装路径替换 E:\MCP-servers-github\Utils\。

控制器UI将打开，允许您监控和控制代理通信。

image

功能“AI聊天”-> 用户可以与所有等待的代理聊天。

image

第二步：在Cursor中设置代理

  1. 打开两个标签页：在Cursor中创建两个独立的聊天标签页 image
  2. 标签页1 - 代理1：键入激活命令以启动代理1
  3. 标签页2 - 代理2：键入激活命令以启动代理2
  4. 执行工具：允许AI调用MCP服务器代理聊天工具
  5. 监控控制器：检查控制器UI中注册的代理
  6. 路由消息：使用控制器UI管理消息传递

激活命令

对于AI交互模式：

  • 越南语：start ai_interaction
  • 英语：start ai_interaction

对于代理通信模式：

  • 越南语：start agent chat 1 或 start agent chat 2
  • 英语：start agent chat 1 或 start agent chat 2

通信流程

  1. 代理注册：代理向各自的工具注册
  2. 消息路由：控制器UI管理消息传递
  3. 优先级系统：管理员命令（SOURCE=admin）具有绝对优先级
  4. 协作：代理讨论并确认执行管理员任务的计划

详细工作流程

初始设置：

  1. 使用 python main_controller.py 启动控制器UI
  2. 打开Cursor，带有两个聊天标签页
  3. 在标签页1中激活代理1：start agent chat 1
  4. 在标签页2中激活代理2：start agent chat 2
  5. 验证两个代理出现在控制器UI的“等待代理”部分

消息通信：

  1. 从代理1发送消息（将出现在消息队列中）
  2. 使用控制器UI将消息路由到代理2
  3. 代理2接收并可以回复
  4. 通过控制器UI路由继续对话

管理员控制：

  • 发送具有绝对优先级的管理员消息
  • 使用“智能投递”进行自动路由
  • 监控实时代理状态
  • 需要时清除数据

管理员控制

  • 绝对权威：管理员消息覆盖所有代理活动
  • 智能投递：自动路由到可用代理
  • 手动路由：对消息传递的精确控制
  • 实时监控：等待代理和消息队列的实时状态

🏗️ 项目结构

Utils/
├── agent_comm/
│   ├── core/                    # 核心系统组件
│   │   ├── config_manager.py    # 配置管理
│   │   ├── flow_manager.py      # 消息流控制
│   │   ├── message_handler.py   # 消息处理
│   │   └── state_manager.py     # 系统状态管理
│   ├── ui/                      # 用户界面组件
│   │   ├── controller_ui.py     # 主控制器界面
│   │   └── styles.py           # UI样式
│   ├── chat_ui/                # 聊天界面系统
│   └── shared_data/            # 持久化数据存储
├── mcp_server_agent1.py        # 代理1 MCP服务器
├── mcp_server_agent2.py        # 代理2 MCP服务器
├── rule_for_AI_VI.txt          # 越南语规则
├── rule_for_AI_EN.txt          # 英语规则
└── README.md                   # 本文件

🎯 关键组件

代理聊天工具

  • mcp_agent_chat_1_agent_chat_1_tool：代理1的通信工具
  • mcp_agent_chat_2_agent_chat_2_tool：代理2的通信工具

控制器特性

  • 消息队列管理
  • 代理状态监控
  • 智能投递系统
  • 文件和图像附件支持
  • 实时刷新能力

规则系统

  • SOURCE标签权限：admin = 绝对优先级，agent = 标准
  • 初始化规则：基于关键词的激活系统
  • 工作流程合规性：强制工具召回和思考块
  • 语言一致性：在整个通信过程中使用越南语或英语

🔧 高级功能

消息类型

  • 文本消息：标准通信
  • 文件附件：文档和代码共享
  • 图像支持：视觉内容通信
  • 混合内容：结合文本、文件和图像

优先级系统

  • 管理员命令：立即执行，覆盖所有活动
  • 代理消息：标准点对点通信
  • 需要协作：代理必须讨论管理员任务的执行

UI控制器

  • 实时更新：1.5秒刷新间隔
  • 多选：批量操作消息
  • 智能路由：自动代理选择
  • 状态跟踪：全面系统监控

🐛 故障排除

常见问题

  1. MCP服务器无法启动

    • 验证配置中的Python路径
    • 检查文件权限
    • 确保已安装所有依赖项

  2. 代理无法通信

    • 确认两个代理均已注册
    • 检查控制器UI中的等待代理
    • 验证规则文件是否正确配置

  3. 消息队列问题

    • 在控制器UI中使用“清除所有数据”
    • 重启MCP服务器
    • 检查shared_data目录权限

💡 相关项目：

https://github.com/KhaiHuynhVN/MCP-Server_AI-interaction