z-mcp-chandao

禅道 (ZenTao) 的 MCP 服务，供 Cursor 等 AI 客户端通过自然语言查询产品、项目、需求、任务和 Bug。

启动时使用禅道登录账号和密码自动换取 API Token，无需在后台手动创建 Token。

前置条件

• Node.js 18+
• 禅道已开启 REST API（后台 → 安全 → API 设置）

快速配置

在项目根目录创建 .cursor/mcp.json：

{
  "mcpServers": {
    "z-mcp-chandao": {
      "command": "npx",
      "args": [
        "-y",
        "z-mcp-chandao",
        "--stdio",
        "--chandao-base-url=https://your-zentao.example.com",
        "--chandao-account=your_account",
        "--chandao-password=your_password"
      ]
    }
  }
}

本地开发时可将 command 改为 node，args 首项指向 ./dist/index.js（需先执行 npm run build）。

配置完成后重启 Cursor，或在 MCP 面板中重新加载该服务。

启动参数

| 参数 | 必填 | 说明 | |------|------|------| | --stdio | 是 | MCP 通信模式 | | --chandao-base-url | 是 | 禅道站点根地址，如 https://zentao.example.com | | --chandao-account | 是 | 禅道登录账号 | | --chandao-password | 是 | 禅道登录密码 |

认证流程：服务启动时向 POST /api.php/v1/tokens（即 baseUrl + /api.php/v1/tokens）提交账号密码获取 Token，后续请求使用 Token: <token> 请求头；业务接口前缀为 /api.php/v1。

提供的工具

| 工具 | 说明 | |------|------| | zentao_list_products | 产品列表（支持 page、limit） | | zentao_get_product | 产品详情，参数 id | | zentao_list_projects | 项目 / 项目集列表 | | zentao_get_project | 项目详情，参数 id | | zentao_list_stories | 产品下的需求列表，参数 productId | | zentao_list_tasks | 迭代下的任务列表，参数 executionId | | zentao_list_bugs | 产品下的 Bug 列表，参数 productId | | zentao_get_bug | Bug 详情，参数 id |

对话示例

• 获取禅道产品列表
• 获取产品 35 下的 Bug 列表
• 查看 Bug 5479 的详情
• 获取项目列表