MCP Agent Coordinator

MCP代理协调员

一种模型上下文协议（MCP）服务器，专门用于协调在Cursor IDE内同一代码库上同时工作的多个AI代理。该系统可防止冲突，管理依赖关系，并确保有组织的并行开发。

为什么代理商协调很重要

当多个AI代理在没有协调的情况下在同一个项目上工作时，它们会造成混乱：文件冲突、重复工作、依赖关系破裂和实现不一致。Agent Coordinator通过引入智能工作流管理来解决这个问题。

这种架构实现了真正的并行开发，代理可以：

• 同时工作，没有冲突 -自动文件锁定可防止多个代理编辑相同的文件
• 遵循逻辑依赖关系 -任务以正确的顺序执行，确保基础工作在依赖功能之前完成
• 保持项目连贯性 -集中的项目结构使所有代理在目标和进度上保持一致
• 高效扩展 -添加更多代理以加速开发而不降低回报
• 跟踪全面进展 -实时查看已完成、正在进行和待处理的内容

该系统将工作组织到项目中→ 任务→ Todo Items，创建清晰的所有权，防止不协调的多代理开发的典型混乱。每个代理都会收到特定的、不冲突的工作分配，并在完成时自动释放资源。

安装

该项目使用Python虚拟环境进行轻松设置。一切都是自给自足的，随时可以运行。

窗户：

start.bat

macOS/Linux：

./start.sh

这会自动创建虚拟环境，安装依赖关系，并在localhost:8001上启动HTTP服务器。

光标配置

将此添加到光标MCP设置中：

{
  "mcpServers": {
    "agent-coordinator": {
      "url": "http://127.0.0.1:8001/sse"
    }
  }
}

基本光标工作流

您几乎需要在所有代理中创建一个包含以下提示的自定义模式

说明：“在开始任何任务之前，请确保您使用代理协调员MCP，从说明中学习，并从那里建立您的工作流程。”

运作原理

该系统管理三个层次的组织：

项目 代表整个代码库或主要计划。每个项目都包含多个任务，并保持整体进度跟踪。

任务 与组相关的工作项，类似于敏捷开发中的sprint。它们定义了主要的里程碑，并可以依赖其他任务来确保正确的顺序。

所有项目 是分配给特定代理人的单个工作单位。它们引用要修改的文件，并自动锁定这些文件以防止冲突。

当代理请求工作时，系统会找到下一个没有阻塞依赖关系或文件冲突的可用待办事项。代理声明工作，系统锁定相关文件，其他代理自动接收不同的任务。完成后，文件解锁，相关工作可用。

这创造了一个自组织的开发环境，代理可以在没有人工干预的情况下自然协调，从而实现真正可扩展的并行开发。

益处

• 消除合并冲突 通过自动文件锁定
• 防止重复工作 具有集中分配跟踪功能
• 维护逻辑执行顺序 通过依赖关系管理
• 扩展到无限代理 没有协调开销
• 提供实时进度可见性 面向项目经理
• 缩短开发时间 通过高效的并行执行
• 确保一致的代码质量 通过维护项目结构