Skip to content
Back to search

zentao-bug-mcp

禅道 bug 抓取 MCP Server:丢一个 bug 链接给 AI 编码助手,自动取完整标题、重现步骤并下载截图附件,AI 直接看图修 bug。只读、免改禅道服务端,适配开源版 18+。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 21 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ikonan/zentao-bug-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ikonan/zentao-bug-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ikonan--zentao-bug-mcp/badge.svg)](/listings/ikonan--zentao-bug-mcp)

HTML

<a href="/listings/ikonan--zentao-bug-mcp"><img src="/api/listings/ikonan--zentao-bug-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 102 lines
  1. # zentao-bug-mcp
  2. 禅道(ZenTao)bug 抓取 MCP Server:在 AI 编码助手(Qoder / Cursor / Claude Code 等)里**直接丢一个禅道 bug 链接**,自动登录禅道、获取 bug 完整标题与重现步骤、把内嵌截图和附件下载到本地,AI 直接看图修 bug。不再需要手动打开网页复制描述、下载截图。
  3. - 适配禅道开源版 18+(含 22.x),走官方 REST API v1,无需改禅道服务端
  4. - 只读工具,不会修改禅道上的任何数据
  5. - 账号密码仅存在于你本机的 MCP 客户端配置中,不落盘、不上传
  6. ## 快速开始
  7. 在 MCP 客户端(Qoder 的 MCP 设置 / Cursor 的 `.cursor/mcp.json`)中添加:
  8. ```json
  9. {
  10. "mcpServers": {
  11. "zentao": {
  12. "command": "npx",
  13. "args": ["-y", "zentao-bug-mcp"],
  14. "env": {
  15. "ZENTAO_BASE_URL": "http://your-zentao-host/zentao",
  16. "ZENTAO_ACCOUNT": "你的禅道账号",
  17. "ZENTAO_PASSWORD": "你的禅道密码"
  18. }
  19. }
  20. }
  21. }
  22. ```
  23. > `ZENTAO_BASE_URL` 是浏览器访问禅道的根地址(含子路径,如 `/zentao`),不要带 `index.php` 或 `api.php`。
  24. 然后在对话里直接说:
  25. ```
  26. 帮我修复这个 bug:http://your-zentao-host/zentao/bug-view-12345.html
  27. ```
  28. AI 会调用 `zentao_get_bug` 拿到标题、步骤和截图本地路径,读图后定位并修复代码。
  29. ## 工具
  30. ### `zentao_get_bug`
  31. | 参数 | 类型 | 说明 |
  32. |---|---|---|
  33. | `bug` | string,必填 | bug 链接(`bug-view-{id}.html` 或 `index.php?m=bug&f=view&bugID={id}`)或纯数字 ID |
  34. | `downloadAttachments` | boolean,默认 `true` | 是否下载附件列表(内嵌截图始终下载) |
  35. 返回 Markdown 报告:完整标题、状态/严重程度/优先级/指派人、重现步骤纯文本(图片位置替换为本地路径)、附件清单、本地文件绝对路径列表。图片下载到系统临时目录 `zentao-mcp/bug-{id}/`,AI 用自身的读文件工具即可查看截图。
  36. ## 配套 Skill
  37. 仓库内置 [`skills/fix-zentao-bug`](skills/fix-zentao-bug/SKILL.md),把修 bug 的最佳实践固化成工作流:取 bug → 逐张查看截图 → 完整保留标题复述 → 最小改动修复 → 验证 → 统一格式汇报,并约束全程只读禅道。
  38. 先配好上面的 MCP,然后一行安装([skills CLI](https://skills.sh),自动识别 Claude Code / Cursor / Codex 等 agent):
  39. ```bash
  40. npx skills add ikonan/zentao-bug-mcp
  41. ```
  42. 或手动复制到 Qoder:
  43. ```bash
  44. git clone https://github.com/ikonan/zentao-bug-mcp.git
  45. cp -r zentao-bug-mcp/skills/fix-zentao-bug ~/.qoder-cn/skills/
  46. ```
  47. 重启会话后直接丢禅道 bug 链接即可自动触发,也可用 `/fix-zentao-bug <链接>` 手动调用。
  48. ## 环境变量
  49. | 变量 | 必填 | 说明 |
  50. |---|---|---|
  51. | `ZENTAO_BASE_URL` | ✅ | 禅道根地址,如 `http://192.168.1.100/zentao` |
  52. | `ZENTAO_ACCOUNT` | ✅ | 禅道登录账号 |
  53. | `ZENTAO_PASSWORD` | ✅ | 禅道登录密码 |
  54. | `ZENTAO_DOWNLOAD_DIR` | | 图片/附件下载目录,默认系统临时目录下 `zentao-mcp/` |
  55. | `ZENTAO_INSECURE_TLS` | | 设为 `1` 跳过 HTTPS 证书校验(内网自签名证书场景) |
  56. ## 排错
  57. | 报错 | 原因与处理 |
  58. |---|---|
  59. | 禅道登录失败(账号或密码错误?) | 检查 env 中的账号密码,确认能登录禅道网页版 |
  60. | REST API v1 不可用 | `ZENTAO_BASE_URL` 不对(少了子路径?)或禅道未开启 RESTful API(后台 → 二次开发 → 应用) |
  61. | 无法连接禅道服务器 | 确认已连公司内网 / VPN |
  62. | HTTPS 证书校验失败 | 内网自签名证书,设置 `ZENTAO_INSECURE_TLS: "1"` |
  63. | 链接主机与 ZENTAO_BASE_URL 不一致 | 安全限制:只向配置的禅道主机发送凭据,换实例请改 env |
  64. | 个别图片下载失败 | 报告中会标注原因,不影响其余内容;常见于文件已被删除 |
  65. ## 本地开发
  66. ```bash
  67. npm install
  68. npm run build # tsc → dist/
  69. npm test # 17 个用例,含本地 mock 禅道的端到端测试
  70. ```
  71. 本地调试时客户端配置可改为 `"command": "node", "args": ["/绝对路径/zentao-mcp/dist/index.js"]`。
  72. ## License
  73. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.