AI导哈

工作流状态管理服务器

MCP协调服务器是一个集中式状态管理系统，用于管理多人开发工作流中的计划、任务和交接状态。

  • by magnus-ffcg
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 magnus-ffcg/mcp-coordinator

使用说明

MCP协调器服务器

一个模型上下文协议（MCP）服务器，它管理多角色开发工作流状态，作为计划、待办事项和交接的权威真实来源。

概述

MCP协调员用一个集中式的状态管理系统替换了角色之间基于文件的通信方式。它不再通过更新 .workflow/docs/ 文件方面，用户与MCP服务器交互以：

  • 存储和检索项目计划
  • 管理任务积压
  • 跟踪不同角色之间的交接情况
  • 保持工作流状态（当前角色、阶段、活跃任务）

安装

选项1：从npm安装（最简单 - 发布后）

# No installation needed - use directly with npx

选项2：本地开发

git clone https://github.com/magnus-ffcg/mcp-coordinator.git
cd mcp-coordinator
npm install
npm run build
npm link  # Makes it available globally

选项3：直接安装

npm install -g mcp-coordinator  # After publishing to npm

使用

MCP配置

在您的IDE的MCP配置中添加：

风帆冲浪（~/.codeium/mcp_config.json）:

{
  "mcpServers": {
    "mcp-coordinator": {
      "command": "npx",
      "args": ["-y", "mcp-coordinator"]
    }
  }
}

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "mcp-coordinator": {
      "command": "npx",
      "args": ["-y", "mcp-coordinator"]
    }
  }
}

备选方案：直接安装

如果你已全局安装：

{
  "mcpServers": {
    "mcp-coordinator": {
      "command": "mcp-coordinator"
    }
  }
}

资源

服务器公开了这些MCP资源：

  • workflow://plan - 当前项目计划，包括架构和需求
  • workflow://backlog - 项目待办事项中的所有任务
  • workflow://handoffs - 所有人物交接的历史记录
  • workflow://state - 当前工作流程状态（角色、阶段、活跃任务）

工具

可用于状态突变的MCP工具：

计划管理

  • create_plan - 创建或更新项目计划
  • 参数：标题、描述、架构、需求、约束

任务管理

  • add_task - 在待办事项列表中添加一个新任务
  • 参数：标题、描述、优先级、验收标准
  • update_task - 更新现有任务
  • 参数：id（标识符）、status（状态）、assignedPersona（分配的角色）、title（标题）、description（描述）、priority（优先级）、acceptanceCriteria（验收标准）

交接管理

  • create_handoff - 在角色之间建立交接流程
  • 参数：来源角色（fromPersona）、目标角色（toPersona）、任务ID（taskId）、已完成工作（completedWork）、下一步行动（nextSteps）、备注（notes）、测试状态（testStatus）、测试运行总结（testRunSummary）、阻碍因素（blockers）

工作流状态

  • set_current_persona - 设置当前激活的角色
  • set_current_stage - 设置当前的TDD阶段（针对TDD工作流程）
  • set_active_task - 设置当前活动任务

数据存储

服务器将状态存储在 ./.workflow-state/state.json 在你的项目目录中。这个文件是自动生成并维护的。

与用户角色（Personas）的集成

人员应使用MCP工具，而非文件操作：

之前（基于文件）：

[ARCHITECT] Updating .workflow/docs/plan.md with architecture decisions...

基于MCP之后：

[ARCHITECT] Creating plan with architecture decisions...

然后，该角色将使用 create_plan 用于在MCP协调器中存储计划的工具。

工作流集成

  1. 建筑师 使用 create_plan 和 add_task 工具
  2. 程序员/测试驱动开发（TDD）开发者 使用 update_task 并且 create_handoff 工具
  3. 测试员 使用 create_handoff 带有测试状态
  4. 评论者 使用 create_handoff 附有审查备注
  5. 问答（QA） 使用 create_handoff 用于最终验证
  6. 利益相关者 使用 update_task 标记为已完成

所有人员都可以通过MCP资源阅读当前状态，以了解上下文和之前的工作情况。

相关 MCP