ZenTao MCP

面向禅道研发协作的 MCP 服务，覆盖总监视角的需求拆解、执行计划和工作量分配建议，以及开发人员视角的任务与 Bug 工作流。

当前状态

当前为 Phase 1 开发阶段，已提供连接诊断和只读查询工具：

• diagnose_connection

• list_projects

• list_executions

• list_products

• list_stories

• list_tasks

• list_execution_tasks

• list_my_tasks

• list_user_tasks

• list_bugs

• list_my_bugs

• list_user_bugs

• list_users

• get_task

• get_story

• get_bug

list_stories 和 list_bugs 需要提供禅道产品 ID，分别访问产品下的需求和 Bug。Agent 可以先调用 list_users，再使用返回的 account 调用 list_user_tasks 或 list_user_bugs，不需要用户手工输入用户名。

写入工具当前默认只生成方案，不执行请求。只有显式传入 confirm: true 才会发送写入请求：

• create_task

• assign_task

• start_task

• finish_task

• complete_task（适合“将 1554 标记为已完成”这类自然语言指令）

• resolve_bug

测试和普通调用不得使用 confirm: true。

Related MCP server: 禅道 MCP Server

本地运行

Copy-Item .env.example .env
npm install
npm run check
npm test
npm run build
npm start

默认通过用户目录配置禅道连接：~/.zentao-mcp/config.json（Windows 为 %USERPROFILE%\\.zentao-mcp\\config.json）。示例：

{
  "baseUrl": "https://your-zentao.example.com",
  "apiPath": "/zentao/api.php/v1",
  "token": "your-token",
  "timeoutMs": 10000
}

环境变量 ZENTAO_CONFIG_FILE 可指定配置文件路径；ZENTAO_* 变量仅作为高级覆盖/补充方式。不要将真实凭证写入仓库。