Skip to content
Back to search

zendao-mcp

MCP server for ZenTao with a self-installing CLI for multiple AI agents

Safety scan

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

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/michael-py001--zendao-mcp/badge.svg)](/listings/michael-py001--zendao-mcp)

HTML

<a href="/listings/michael-py001--zendao-mcp"><img src="/api/listings/michael-py001--zendao-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

在自己的电脑上运行(不用 clone 仓库、不用预装依赖):

npx -y @michael_py001/zendao-mcp init

交互式填站点地址 / 账号 / 密码,自动检测本机 agent 并写入配置,形如:

{
  "mcpServers": {
    "zentao-cli": {
      "command": "npx",
      "args": ["-y", "@michael_py001/zendao-mcp", "mcp"],
      "env": {
        "ZENTAO_URL": "http://zen.example.com/zentaomax",
        "ZENTAO_ACCOUNT": "your-account",
        "ZENTAO_PASSWORD": "your-password"
      }
    }
  }
}

⚠️ 凭证明文写进 agent 配置,别把含密码的配置提交到 git。安装器会另存一份到 `~/.zendao-mcp/.env`(权限 600)供下次复用;写配置前自动备份、原子替换,JSONC 注释原样保留。

- **自动写入配置(25 个)**:WorkBuddy、Claude Code、Claude Desktop、Cursor、Codex、OpenCode、Gemini CLI、VS Code、Windsurf、Cline、Roo Code、Kilo Code、Zed、GitHub Copilot CLI、Kiro、Continue、Qwen Code、Antigravity、Trae、CodeBuddy、Droid、Augment、Qoder、Devin、Amp - **另支持 57 个手工配置**:`-a <id>` 选中后打印可复制的命令,不猜路径写文件;`--list-agents` 看全部 ID

npx -y @michael_py001/zendao-mcp init --dry-run     # 只看计划
npx -y @michael_py001/zendao-mcp init -a cursor -y  # 非交互
npx -y @michael_py001/zendao-mcp doctor             # 检查安装状态

启动命令是 `npx -y @michael_py001/zendao-mcp mcp`(`serve` 兼容)。WorkBuddy 需在连接器中心点「信任」。从 1.1.x 升级:重跑 `init` 写新条目,删掉旧的 `zendao` 条目。

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 · 116 lines
  1. # ZenTao MCP Server
  2. 让 AI 客户端(Claude / Cursor / WorkBuddy 等)通过 [MCP](https://modelcontextprotocol.io/) 读写禅道的项目、任务、Bug 和工时。
  3. - **传输**:stdio|**API**:禅道 API 2.0(可回落 v1)|**认证**:账号密码自动换 Token,401 自动重换
  4. - **16 个工具**:通用层 3 个由官方 `zentao-api@0.9.3` 注册表驱动(43 模块 × 365 动作,按实例版本自动过滤);手写 13 个补官方给不了的实例能力
  5. ## 安装
  6. 在自己的电脑上运行(不用 clone 仓库、不用预装依赖):
  7. ```bash
  8. npx -y @michael_py001/zendao-mcp init
  9. ```
  10. 交互式填站点地址 / 账号 / 密码,自动检测本机 agent 并写入配置,形如:
  11. ```json
  12. {
  13. "mcpServers": {
  14. "zentao-cli": {
  15. "command": "npx",
  16. "args": ["-y", "@michael_py001/zendao-mcp", "mcp"],
  17. "env": {
  18. "ZENTAO_URL": "http://zen.example.com/zentaomax",
  19. "ZENTAO_ACCOUNT": "your-account",
  20. "ZENTAO_PASSWORD": "your-password"
  21. }
  22. }
  23. }
  24. }
  25. ```
  26. ⚠️ 凭证明文写进 agent 配置,别把含密码的配置提交到 git。安装器会另存一份到 `~/.zendao-mcp/.env`(权限 600)供下次复用;写配置前自动备份、原子替换,JSONC 注释原样保留。
  27. - **自动写入配置(25 个)**:WorkBuddy、Claude Code、Claude Desktop、Cursor、Codex、OpenCode、Gemini CLI、VS Code、Windsurf、Cline、Roo Code、Kilo Code、Zed、GitHub Copilot CLI、Kiro、Continue、Qwen Code、Antigravity、Trae、CodeBuddy、Droid、Augment、Qoder、Devin、Amp
  28. - **另支持 57 个手工配置**:`-a <id>` 选中后打印可复制的命令,不猜路径写文件;`--list-agents` 看全部 ID
  29. ```bash
  30. npx -y @michael_py001/zendao-mcp init --dry-run # 只看计划
  31. npx -y @michael_py001/zendao-mcp init -a cursor -y # 非交互
  32. npx -y @michael_py001/zendao-mcp doctor # 检查安装状态
  33. ```
  34. 启动命令是 `npx -y @michael_py001/zendao-mcp mcp`(`serve` 兼容)。WorkBuddy 需在连接器中心点「信任」。从 1.1.x 升级:重跑 `init` 写新条目,删掉旧的 `zendao` 条目。
  35. ## 从源码运行
  36. Node.js ≥ 18:`npm install && npm run build`,复制 `.env.example` 为 `.env` 填凭证,`npm run verify` 自检。
  37. ## Skill(随 init 自动安装)
  38. MCP 工具连上后 agent 能自动发现工具,但**工作流和铁律**(填日志前出清单确认、`dryRun` 不是确认、实例踩坑)需要一份 Skill 才能可靠传递。
  39. `init` 在写 MCP 配置的**同时**,把 Skill 自动装到选中 agent 的 skills 目录,无需手动操作。已存在则跳过、不覆盖你改过的内容;`--dry-run` 只打印计划不写文件。结果里会单列 `Skill:` 段,显示每个 agent 的安装路径。
  40. 自动安装的 agent(有公开可靠的 skills 路径):Claude Code、Cursor、Codex、OpenCode、Gemini CLI、VS Code / Copilot、Antigravity、Cherry Studio、WorkBuddy。其余只提供手工配置的 agent 不会被装 Skill。
  41. **手工补装**(上面名单之外的 agent,或想覆盖已装的):
  42. ```bash
  43. # 从 npm 包解出(在任意空目录执行)
  44. npm pack @michael_py001/zendao-mcp
  45. tar -xzf michael_py001-zendao-mcp-1.3.1.tgz # Windows 自带 tar 亦可
  46. # 把 package/skills/zendao-mcp/ 整个目录复制到该 agent 的 skills 目录下
  47. # clone 了仓库时,直接复制仓库里的 skills/zendao-mcp/ 即可
  48. ```
  49. 常见 skills 目录:Claude Code `~/.claude/skills/`、Cursor `~/.cursor/skills/`、Codex `~/.agents/skills/`、OpenCode `~/.config/opencode/skills/`、Gemini CLI `~/.gemini/skills/`、WorkBuddy `~/.workbuddy/skills/`(项目级用工作区 `.workbuddy/skills/`)。
  50. 装好后 agent 会在相关任务(操作禅道数据、查我的待办、填工时、读附件)时自动加载它。
  51. ## 能做什么
  52. **通用层(3 个)**:`zendao_modules` 看有哪些动作 → `zendao_help { module, action }` 查参数 → `zendao_call { module, action, params }` 执行。覆盖官方全部 43 模块 / 365 动作,按实例版本自动过滤,不需要编译期适配。
  53. **手写层(13 个)**:
  54. | 场景 | 工具 |
  55. | --- | --- |
  56. | Bug | `zendao_list_bugs`(含全库合并)· `zendao_get_bug` · `zendao_get_bug_attachments` · `zendao_list_my_bugs` |
  57. | 我的地盘 | `zendao_list_my_work`(任务/需求/待办/Bug)· `zendao_list_my_efforts`(工时日志) |
  58. | 任务 / 人员 | `zendao_get_task` · `zendao_list_users` · `zendao_batch_create_tasks` |
  59. | 附件 / 链接 | `zendao_read_attachment`(任意对象附件)· `zendao_link`(生成 / 解析页面 URL) |
  60. | 工时写入 | `zendao_fill_efforts` · `zendao_delete_effort` |
  61. ⚠️ **写操作**:`zendao_call`(写类动作)、`zendao_batch_create_tasks`、`zendao_fill_efforts`、`zendao_delete_effort` 会真往禅道写数据;其余只读。填日志默认只预览,`dryRun: false` 才真写。
  62. 禅道有两条分层线:**任务挂「执行」下**(要 `executionID`),**Bug 挂「产品」下**(要 `productID`);没有全局任务列表,全库 Bug 靠逐产品合并。详见 [MCP-SETUP.md](./MCP-SETUP.md)。
  63. ## 多站点 / 多版本
  64. 改 `ZENTAO_BASE_URL` 即可换站点,同一份构建通用;版本适配在运行时按官方注册表的 `minVersion` 判定,不满足会给人话提示。凭证三源优先级:账号密码 → `ZENTAO_TOKEN` → 官方 CLI 登录态(后者只有 Token、有寿命,不宜长期无人值守)。全部变量见 [`.env.example`](./.env.example)。
  65. ## 版本更新
  66. | 版本 | 更新内容 |
  67. | --- | --- |
  68. | **1.3.2** | `init` 时自动把 Skill 装到各 agent 的 skills 目录(已存在不覆盖,`--dry-run` 可预览) |
  69. | 1.3.1 | 随包附送 `skills/zendao-mcp/SKILL.md`(Agent 工具选择、写操作铁律、实例踩坑) |
  70. | 1.3.0 | 升级 `zentao-api` 至 0.9.3:官方动作 229 → 365、模块 26 → 43;新增 `zendao_link`(页面链接生成/解析)和 `zendao_read_attachment`(从 URL / HTML / fileID 读取任意对象附件),工具总数 16 个 |
  71. | 1.2.0 | 配置形态改为 `mcp` 子命令 + 凭证明文写入各 agent 的 `env`;`serve` 保留为兼容别名 |
  72. | 1.1.0 | 安装器支持 82 个 agent(25 个自动写入 + 57 个手工指引),写配置时保留 JSONC 注释与尾随逗号 |
  73. | 1.0.0 | 首次发布:`init` 一键安装、`mcp` 启动,凭证明文写入 agent 配置 |
  74. ## 文档
  75. - [MCP-SETUP.md](./MCP-SETUP.md) — 接入配置、认证、参数、典型坑与实例行为
  76. - [MCP_TESTING_GUIDE.md](./MCP_TESTING_GUIDE.md) — 验证与测试
  77. - [docs/official-module-parity.md](./docs/official-module-parity.md) — 官方模块 / 动作对照表
  78. - [docs/instance-compatibility-matrix.md](./docs/instance-compatibility-matrix.md) — 实例兼容性矩阵
  79. - [skills/zendao-mcp/SKILL.md](./skills/zendao-mcp/SKILL.md) — Agent 使用指南(工具选择、写操作铁律、实例踩坑),随包分发,可复制到 agent 的 skills 目录
  80. ## 安全与许可
  81. 不要提交 `.env`(已在 `.gitignore`)。许可:[MIT](./LICENSE)。

Ratings and comments

Sign in to rate this skill.

Sign in

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