zentao-dev-mcp

面向开发者的禅道 MCP Server，在 Cursor IDE 中快速查询和操作禅道数据。

功能概览

提供 20 个 MCP 工具，覆盖任务、Bug、需求、产品的查询与管理：

任务管理 (7 个工具)

| 工具 | 说明 | |---|---| | get_my_tasks | 获取我的任务列表（支持按指派/创建/完成/待处理筛选） | | get_task_detail | 查看任务详情 | | create_task | 创建新任务 | | edit_task | 编辑任务 | | start_task | 开始任务（状态变更为进行中） | | finish_task | 完成任务 | | assign_task | 指派任务给他人 |

Bug 管理 (8 个工具)

| 工具 | 说明 | |---|---| | get_my_bugs | 获取我的 Bug 列表 | | search_bugs | 按产品搜索 Bug（支持状态/指派人/日期筛选） | | get_bug_detail | 查看 Bug 详情 | | create_bug | 创建新 Bug | | edit_bug | 编辑 Bug | | resolve_bug | 解决 Bug | | close_bug | 关闭 Bug | | activate_bug | 重新激活 Bug |

需求查询 (3 个工具)

| 工具 | 说明 | |---|---| | get_my_stories | 获取我负责的需求列表 | | get_story_detail | 查看需求详情（含关联任务） | | get_product_stories | 按产品查询需求列表 |

产品查询 (2 个工具)

| 工具 | 说明 | |---|---| | get_product_list | 获取所有可见产品列表 | | get_product_detail | 查看产品详情 |

安装

npm install
npm run build

环境变量

| 变量 | 说明 | 必填 | |---|---|---| | ZENTAO_BASE_URL | 禅道服务器地址（如 https://zentao.example.com） | 是 | | ZENTAO_CODE | 用户工号（认证 code） | 是 | | ZENTAO_KEY | API 密钥 | 是 |

Cursor MCP 配置

在 ~/.cursor/mcp.json 中添加：

{
  "mcpServers": {
    "zentao-dev": {
      "command": "node",
      "args": ["/path/to/zentao-dev-mcp/dist/index.js"],
      "env": {
        "ZENTAO_BASE_URL": "https://zentao.example.com",
        "ZENTAO_CODE": "your-code",
        "ZENTAO_KEY": "your-api-key"
      }
    }
  }
}

或通过 npx 方式：

{
  "mcpServers": {
    "zentao-dev": {
      "command": "npx",
      "args": ["-y", "/path/to/zentao-dev-mcp"],
      "env": {
        "ZENTAO_BASE_URL": "https://zentao.example.com",
        "ZENTAO_CODE": "your-code",
        "ZENTAO_KEY": "your-api-key"
      }
    }
  }
}

技术栈

• TypeScript + ESM
• @modelcontextprotocol/sdk v1.x（McpServer 高级 API）
• zod — 运行时参数验证
• Node.js >= 18 — 使用内置 fetch 和 crypto