task-pool-mcp

基于 GitHub Issues 的 AI 开发团队任务池。Leader 发布任务，Worker（人或 AI Agent）认领并执行，支持任务依赖关系，AI 完成后由人 Review。通过 MCP 协议接入任意 vibe coding 工具（Claude Code、Cursor、Windsurf 等）。

快速开始

1. 安装

npx task-pool-mcp

或直接克隆后运行：

git clone <repo>
cd task-pool-mcp
npm install

2. 配置环境变量

复制 .env.example 为 .env 并填写：

GITHUB_TOKEN=ghp_xxxx        # GitHub Personal Access Token
GITHUB_REPO=owner/repo-name  # 目标仓库

Token 需要 repo 权限以读写 Issues。

3. 接入 MCP

在 Claude Code / Cursor / Windsurf 的 MCP 配置中添加：

{
  "mcpServers": {
    "task-pool": {
      "command": "npx",
      "args": ["task-pool-mcp"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxx",
        "GITHUB_REPO": "owner/repo-name"
      }
    }
  }
}

任务状态机

pending → available → assigned → in-progress → in-review → done
                ↑                                    |
             blocked ←──────────────────────────────┘（Review 不通过回退）
                |
         （前置任务 done 后自动解锁 → available）

| 状态 | label | |-------------|------------------| | pending | tp:pending | | blocked | tp:blocked | | available | tp:available | | assigned | tp:assigned | | in-progress | tp:in-progress | | in-review | tp:in-review | | done | tp:done |

MCP Tools

| Tool | 调用者 | 说明 | |-----------------|---------------|---------------------------------| | create_task | Leader | 创建任务，支持依赖和优先级 | | list_tasks | 任何人 | 按状态/指派者过滤任务列表 | | claim_task | Worker/AI | 认领可用任务 | | update_progress | Worker/AI | 更新进度并追加评论 | | complete_task | Leader | Review 通过后完成并解锁下游任务 | | get_board | Leader | 按维度分组查看任务看板 |

角色指南

• Leader: 参考 skills/leader.md
• Worker / AI Agent: 参考 skills/worker.md

技术栈

• TypeScript (Node.js 18+)
• @modelcontextprotocol/sdk
• @octokit/rest
• tsx 直接运行，无需编译