禅道 Bug MCP

面向 AI 修 Bug 场景的禅道 MCP Server。通过 Cursor / Claude 等 MCP 客户端，读取禅道 Bug、获取 AI 友好的重现步骤摘要，并在修复完成后受控回写禅道状态。

适配 禅道开源版 16.5+ / 18.12，REST API v1：${ZENTAO_URL}/api.php/v1。

一键安装

无需 clone 仓库，复制一条命令执行即可。脚本会自动从 GitHub 下载、安装依赖、构建，并交互式询问禅道账号与 AI 平台；也可选择「稍后配置」账号。

macOS / Linux：

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

Windows PowerShell：

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

安装过程：

1. 下载到 ~/.local/share/zentao-mcp（Windows：%LOCALAPPDATA%\zentao-mcp）

2. 自动 npm install + 构建

3. 询问禅道地址 / 账号 / 密码（可跳过，稍后在 MCP 配置的 env 里填写）

4. 自动检测本机 AI 客户端并写入 MCP 配置

安装完成后重启 AI 客户端，对话测试：调用 zentao_health_check 检查禅道连接

查看安装命令：npm run install:urls

稍后配置禅道账号

安装时选「否」跳过账号，或安装完成后编辑 MCP 配置文件里 zentao 的 env：

"env": {
  "ZENTAO_URL": "https://your-zentao-host",
  "ZENTAO_ACCOUNT": "your_account",
  "ZENTAO_PASSWORD": "your_password",
  "ZENTAO_SKIP_SSL": "true"
}

常见路径：~/.cursor/mcp.json（Cursor）、Claude Desktop 的 claude_desktop_config.json 等。

CI / 批量部署（可选）

ZENTAO_URL=https://zentao.example.com \
ZENTAO_ACCOUNT=bot \
ZENTAO_PASSWORD=secret \
curl -fsSL https://raw.githubusercontent.com/ceeyang/zentao_mcp/main/install.sh | bash -s -- --yes

Related MCP server: yo-bug

功能

支持的 AI 平台

cursor · claude · claude_code · windsurf · trae · trae_cn · vscode · cline · opencode · continue · zed · kiro · roocode · amazonq · copilot_cli · gemini · kimi · codex

安装时默认 auto 自动检测，详见 docs/INSTALL.zh-CN.md。

维护者

git clone https://github.com/ceeyang/zentao_mcp.git
cd zentao_mcp
npm install && npm run build
./install.sh

npm run test:install     # 本地 E2E
npm run verify:github    # 检查 GitHub raw 是否可访问
npm run pack:release     # 离线 tgz 包

环境变量

License

MIT