ceeyang/zentao_mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

6 stars 2 forks Качество 87 Тренд 22MIT

Repository Install

ZenTao Bug MCP server for AI-assisted bug fixing (Cursor, Claude, etc.)

Обзор

也可以全局装：npm i -g @ceeyang/zentao-mcp，然后把 command 换成 zentao-mcp、args 留空。 Windows：irm https://raw.githubusercontent.com/ceeyang/zentao_mcp/main/install.ps1 | iex 装完，按上表开聊即可。更多示例 → docs/FEATURES.zh-CN.md - **从 GitHub 下载、构建、写入 MCP 配置（~/.local/share/zentao-mcp） - ：现场输入禅道账号，或选「稍后配置」 - ：Cursor、Claude Desktop、Claude Code、Windsurf、Trae、VS Code、Cline、OpenCode、Continue、Zed 等（INSTALL_PLATFORMS=auto 自动检测） - ，避免 Cursor spawn ENOENT 先用 zentao_list_scopes 找 ID：建需求要**，建任务要**。改需求描述请用 zentao_change_story——禅道把 spec/verify 和其它字段分开版本化，普通更新接口不会改描述。另外 18.x 的 PUT /stories/:id 在需求没有评审人时会被禅道拒绝，此时工具会返回 REVIEWER_REQUIRED 并提示补 reviewer。 - 产品白名单 ZENTAO_ALLOWED_PRODUCTS - 自签名 HTTPS ZENTAO_SKIP_SSL - Token / 账号密码双模式，401 自动刷新 - 统一 JSON 响应信封，方便 AI 解析 - Bug 、群机器人（需另建服务，见讨论方向） - 需求评审流程（review / submitreview）、任务批量创建

README

Показан фрагмент оригинального README. Открыть оригинал.

禅道 MCP

让 Cursor / Claude / Windsurf 等 AI 直接读写禅道的 Bug / 需求(story) / 任务(task)。

适配禅道开源版 16.5+ / 18.12 · REST API v1

30 秒：能干什么

你想…	在 AI 里这样说
确认装好了	「调用 zentao_health_check 检查禅道连接」
看我负责的 Bug	「列出指派给我的 Bug，最新的 10 条」
读重现步骤修 Bug	「读取 Bug #12345 详情，按 steps 帮我改代码」
查某产品下的需求	「列出产品 3 下未关闭的需求」
提一个需求	「在产品 3 下建需求：标题 xxx，描述 yyy」（需开写权限）
拆任务 / 报工	「在迭代 5 下给 alice 建开发任务，预计 4 小时」「把任务 #88 标完成，消耗 3 小时」
修完回写禅道	「dryRun 预演把 #12345 标为 fixed，备注 xxx」（需开写权限）

安装方式一：npm（推荐）

在 AI 客户端的 MCP 配置里直接用 npx，无需 clone、无需构建：

{
  "mcpServers": {
    "zentao": {
      "command": "npx",
      "args": ["-y", "@ceeyang/zentao-mcp"],
      "env": {
        "ZENTAO_URL": "https://your-zentao-host",
        "ZENTAO_ACCOUNT": "your_account",
        "ZENTAO_PASSWORD": "your_password"
      }
    }
  }
}

也可以全局装：npm i -g @ceeyang/zentao-mcp，然后把 command 换成 zentao-mcp、args 留空。

安装方式二：一条命令脚本安装

curl -fsSL https://raw.githubusercontent.com/ceeyang/zentao_mcp/main/install.sh | bash

Windows：irm https://raw.githubusercontent.com/ceeyang/zentao_mcp/main/install.ps1 | iex

会自动下载、构建，并写入检测到的 18 种 AI 客户端配置。

装完 重启 AI 客户端，按上表开聊即可。更多示例 → docs/FEATURES.zh-CN.md

已实现功能

安装与集成

一条命令从 GitHub 下载、构建、写入 MCP 配置（~/.local/share/zentao-mcp）
交互安装：现场输入禅道账号，或选「稍后配置」
18 种 AI 客户端：Cursor、Claude Desktop、Claude Code、Windsurf、Trae、VS Code、Cline、OpenCode、Continue、Zed 等（INSTALL_PLATFORMS=auto 自动检测）
node 绝对路径，避免 Cursor spawn ENOENT

读 Bug（默认开启）

工具	能力
`zentao_list_my_bugs`	指派给当前账号的 Bug（不用记产品 ID）
`zentao_list_bugs`	按产品 / 项目 / 执行筛选
`zentao_get_bug`	详情 + HTML 重现步骤转纯文本（`stepsPlain`）
`zentao_health_check`	连通性 + 写权限开关状态

写 Bug（默认关闭，防误操作）

工具	需环境变量
`zentao_resolve_bug`	`ZENTAO_ALLOW_RESOLVE_BUG=true`
`zentao_close_bug`	`ZENTAO_ALLOW_CLOSE_BUG=true`
`zentao_activate_bug`	`ZENTAO_ALLOW_ACTIVATE_BUG=true`

均支持 dryRun: true 先预演。详见功能示例。

需求 story / 任务 task

先用 zentao_list_scopes 找 ID：建需求要产品 ID，建任务要迭代(execution) ID。

工具	能力	需环境变量
`zentao_list_scopes`	列产品 / 项目 / 迭代，拿 ID	只读
`zentao_list_stories`	按产品 / 项目 / 迭代列需求	只读
`zentao_get_story`	详情 + 描述/验收标准转纯文本、关联任务与 Bug	只读
`zentao_create_story`	提需求	`ZENTAO_ALLOW_WRITE_STORY=true`
`zentao_update_story`	改标题 / 优先级 / 分类 / 模块等	同上
`zentao_change_story`	改描述 / 验收标准（禅道单独版本化，会升版本号）	同上
`zentao_close_story` / `zentao_assign_story`	关闭 / 指派	同上
`zentao_list_tasks`	列迭代下任务；不传 `executionId` 就是「我的任务」	只读
`zentao_get_task`	详情 + 描述纯文本 + 操作历史	只读
`zentao_create_task`	拆任务	`ZENTAO_ALLOW_WRITE_TASK=true`
`zentao_update_task`	改字段	同上
`zentao_start_task` / `zentao_finish_task`	开始 / 完成（报工）	同上

Открыть полный README на GitHub

Установка

npx -y @ceeyang/zentao-mcp

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "zentao": {
      "command": "npx",
      "args": ["-y", "@ceeyang/zentao-mcp"],
      "env": {
        "ZENTAO_URL": "https://your-zentao-host",
        "ZENTAO_ACCOUNT": "your_account",
        "ZENTAO_PASSWORD": "your_password"
      }
    }
  }
}