MCP Agent Coordinator

专为Cursor IDE中多个AI代理同时在同一代码库上工作而设计的模型上下文协议（MCP）服务器。该系统防止冲突，管理依赖关系，并确保有序的并行开发。

为什么代理协调很重要

当多个AI代理在没有协调的情况下在同一项目上工作时，会产生混乱：文件冲突、重复工作、破坏依赖关系以及不一致的实现。代理协调器通过引入智能工作流管理解决了这个问题。

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

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

该系统将工作组织成项目→任务→待办事项，创建明确的所有权并防止未协调多代理开发的典型混乱。每个代理接收特定的、非冲突的工作分配，并在完成后自动释放资源。

安装

该项目使用Python虚拟环境进行简单设置。一切自包含且准备好运行。

Windows:

start.bat

macOS/Linux:

./start.sh

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

Cursor配置

将以下内容添加到您的Cursor MCP设置中：

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

必要的Cursor工作流程

强烈建议您创建一个自定义模式或在所有代理中包含以下提示

指令："在开始任何任务之前，请确保使用代理协调器MCP，学习相关指令，并从此处建立您的工作流程。"

工作原理

该系统管理三个级别的组织：

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

任务将相关的工件分组，类似于敏捷开发中的冲刺。它们定义主要里程碑，并可以依赖其他任务以确保适当的顺序。

待办事项是分配给特定代理的单个工作单元。它们引用将修改的文件，并自动锁定这些文件以防止冲突。

当代理请求工作时，系统找到下一个可用的待办事项，没有阻止的依赖关系或文件冲突。代理认领工作，系统锁定相关文件，其他代理自动获得不同的分配。完成后，文件解锁，依赖的工作变得可用。

这创建了一个自我组织的开发环境，代理自然协调无需人工干预，从而实现真正可扩展的并行开发。

优势

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