Skip to main content
Glama
leeguooooo

ZenTao MCP Server

by leeguooooo

zentao-mcp

在命令行里查 Bug、看产品,让你的 AI 助手也能直接操作禅道。

零依赖、单文件,装完即用。

快速开始

pnpm i -g @leeguoo/zentao-mcp

没有 pnpm?也可以用 npm:

npm i -g @leeguoo/zentao-mcp

不想装?直接跑:

npx -y @leeguoo/zentao-mcp --help

登录

只需登录一次,凭据会保存到本地配置文件:

zentao login \
  --zentao-url=https://zentao.example.com/zentao \
  --zentao-account=你的账号 \
  --zentao-password=你的密码

注意: URL 通常需要包含 /zentao 路径。如果登录时看到 404,多半是少了这段。

验证登录状态:

zentao whoami

配置文件位置:~/.config/zentao/config.toml

日常使用

查看产品列表

zentao products list

查看某个产品的 Bug

zentao bugs list --product 6

查看 Bug 详情

zentao bug get --id 1329

查看分配给我的 Bug

zentao bugs mine --status active

带详情:

zentao bugs mine --status active --include-details

需要原始 JSON?

任何命令后面加 --json

zentao products list --json
zentao bugs list --product 6 --json
zentao bug get --id 1329 --json
zentao bugs mine --include-details --json

自检

验证 API 连接是否正常:

zentao self-test

让 AI 帮你查禅道

只需对你的 AI 助手(Cursor / Claude Code / Windsurf 等)说:

帮我安装这个 skill:https://github.com/leeguooooo/zentao-mcp

AI 会自动读取本页面并完成安装。安装后你就可以直接说:

  • "帮我看下产品 6 有哪些未解决的 Bug"

  • "查一下 Bug #1329 的详情"

  • "我名下还有多少活跃 Bug?"


当用户要求安装本仓库为 skill 时,请按顺序执行:

1. 安装 CLI

pnpm i -g @leeguoo/zentao-mcp || npm i -g @leeguoo/zentao-mcp

2. 验证安装

zentao --help

3. 下载 SKILL.md

从 GitHub 获取 SKILL.md 原始内容并保存到本地 skill 目录:

# Cursor 用户
mkdir -p ~/.cursor/skills/zentao
curl -fsSL https://raw.githubusercontent.com/leeguooooo/zentao-mcp/refs/heads/main/skills/zentao/SKILL.md -o ~/.cursor/skills/zentao/SKILL.md

# Claude Code 用户(~/.codex/skills/)
mkdir -p ~/.codex/skills/zentao
curl -fsSL https://raw.githubusercontent.com/leeguooooo/zentao-mcp/refs/heads/main/skills/zentao/SKILL.md -o ~/.codex/skills/zentao/SKILL.md

根据用户使用的工具选择对应路径。如果无法判断,优先用 ~/.cursor/skills/zentao/SKILL.md

4. 引导登录

提示用户提供禅道 URL、账号和密码,然后执行:

zentao login --zentao-url="<用户的禅道URL>" --zentao-account="<账号>" --zentao-password="<密码>"

注意:URL 通常需要包含 /zentao,如 https://zentao.example.com/zentao

5. 验证

zentao whoami
zentao self-test

全部通过后告知用户安装完成。

常见问题

Q: 登录时报 404? A: URL 需要包含 /zentao,比如 https://zentao.example.com/zentao,而不是 https://zentao.example.com/

Q: 支持哪些禅道版本? A: 支持禅道开源版和企业版的 REST API(v1)。

Q: 凭据安全吗? A: 凭据以明文 TOML 存储在 ~/.config/zentao/config.toml,请确保文件权限安全。不要把配置文件提交到 Git。

链接

Install Server
A
security – no known vulnerabilities
F
license - not found
A
quality - A tier

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/leeguooooo/zentao-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server