zentao-bug-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
zentao-bug-mcp
禅道(ZenTao)bug 抓取 MCP Server:在 AI 编码助手(Qoder / Cursor / Claude Code 等)里直接丢一个禅道 bug 链接,自动登录禅道、获取 bug 完整标题与重现步骤、把内嵌截图和附件下载到本地,AI 直接看图修 bug。不再需要手动打开网页复制描述、下载截图。
适配禅道开源版 18+(含 22.x),走官方 REST API v1,无需改禅道服务端
只读工具,不会修改禅道上的任何数据
账号密码仅存在于你本机的 MCP 客户端配置中,不落盘、不上传
快速开始
在 MCP 客户端(Qoder 的 MCP 设置 / Cursor 的 .cursor/mcp.json)中添加:
{
"mcpServers": {
"zentao": {
"command": "npx",
"args": ["-y", "zentao-bug-mcp"],
"env": {
"ZENTAO_BASE_URL": "http://your-zentao-host/zentao",
"ZENTAO_ACCOUNT": "你的禅道账号",
"ZENTAO_PASSWORD": "你的禅道密码"
}
}
}
}
ZENTAO_BASE_URL是浏览器访问禅道的根地址(含子路径,如/zentao),不要带index.php或api.php。
然后在对话里直接说:
帮我修复这个 bug:http://your-zentao-host/zentao/bug-view-12345.htmlAI 会调用 zentao_get_bug 拿到标题、步骤和截图本地路径,读图后定位并修复代码。
Related MCP server: ZenTao MCP Server
工具
zentao_get_bug
参数 | 类型 | 说明 |
| string,必填 | bug 链接( |
| boolean,默认 | 是否下载附件列表(内嵌截图始终下载) |
返回 Markdown 报告:完整标题、状态/严重程度/优先级/指派人、重现步骤纯文本(图片位置替换为本地路径)、附件清单、本地文件绝对路径列表。图片下载到系统临时目录 zentao-mcp/bug-{id}/,AI 用自身的读文件工具即可查看截图。
环境变量
变量 | 必填 | 说明 |
| ✅ | 禅道根地址,如 |
| ✅ | 禅道登录账号 |
| ✅ | 禅道登录密码 |
| 图片/附件下载目录,默认系统临时目录下 | |
| 设为 |
排错
报错 | 原因与处理 |
禅道登录失败(账号或密码错误?) | 检查 env 中的账号密码,确认能登录禅道网页版 |
REST API v1 不可用 |
|
无法连接禅道服务器 | 确认已连公司内网 / VPN |
HTTPS 证书校验失败 | 内网自签名证书,设置 |
链接主机与 ZENTAO_BASE_URL 不一致 | 安全限制:只向配置的禅道主机发送凭据,换实例请改 env |
个别图片下载失败 | 报告中会标注原因,不影响其余内容;常见于文件已被删除 |
本地开发
npm install
npm run build # tsc → dist/
npm test # 17 个用例,含本地 mock 禅道的端到端测试本地调试时客户端配置可改为 "command": "node", "args": ["/绝对路径/zentao-mcp/dist/index.js"]。
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Redmine MCP server for ChatGPT, Claude and any AI agent: create issue, update issue, log time, list my issues, add comment and list projects in your own Redmine account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Redmine yourself; Cotlet does not store your password and you need no Redmine API key. About the official Redmine API: Yes, Redmine has a REST API (checked 16 Oct 2026). Issues, projects, users and time entries are marked Stable, in JSON or XML, with an API key per user; an administrator must first turn on Enable REST API under Administration > Settings > API. Setup and FAQ: https://cotlet.dev/integrations/redmine-api-mcp-server
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
Buildium MCP server for ChatGPT, Claude and any AI agent: record lease payment, list outstanding balances, send text message, create task, add work order and send announcement in your own Buildium account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Buildium yourself; Cotlet does not store your password and you need no Buildium API key. About the official Buildium API: Yes, Buildium has an official REST API, the Open API, but only on the Premium plan (checked 27 Oct 2026). Buildium's developer guide says "To take advantage of the Buildium Open API you must have a Premium Subscription", and an administrator has to switch it on under Settings > Application settings > Api settings before anyone can create a key. Setup and FAQ: https://cotlet.dev/integrations/buildium-api-mcp-server
Zendesk MCP server for ChatGPT, Claude and any AI agent: list tickets, reply to ticket, update ticket, apply macro, add internal note and search tickets in your own Zendesk account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Zendesk yourself; Cotlet does not store your password and you need no Zendesk API key. About the official Zendesk API: Zendesk has a full REST API, the Support API (also called the Ticketing API), but no documented Zendesk-hosted MCP server for working tickets (checked 16 Oct 2026). Zendesk's MCP documentation covers the MCP client, where Zendesk calls other servers. Setup and FAQ: https://cotlet.dev/integrations/zendesk-api-mcp-server
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with ZenTao bug tracking system to search products, query assigned bugs, view bug details with extracted images, and mark bugs as resolved through natural language commands.9 npm7ISC
- FlicenseBqualityNot gradedmaintenanceEnables interaction with ZenTao project management system through RESTful API v1. Supports bug tracking, project/product management, and automated token authentication for seamless integration.102-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Zentao bugs, requirements, and test cases through natural language interactions. It supports querying, creating, and updating various Zentao data entities including products, projects, and executions.12MIT
- FlicenseNot gradedqualityDmaintenanceEnables query and management of Zentao bugs, tasks, projects, and iterations directly from MCP-compatible IDEs like Cursor or Claude Desktop.-