zentao
Enables full CRUD operations on Zentao entities like requirements, bugs, tasks, test cases, projects, and products through natural language.
README
zentao
禅道 (Zentao) 通用 MCP Server,支持需求/Bug/任务/用例/项目/产品等全部读写操作。
安装
cd ~/.cc-switch/mcp-servers/zentao
npm install
在 Claude Code 中注册
编辑 ~/.claude/mcp.json,添加:
{
"mcpServers": {
"zentao": {
"command": "node",
"args": ["/Users/pengxu.hou/.cc-switch/mcp-servers/zentao/src/index.js"]
}
}
}
凭据(ZENTAO_BASE_URL / ZENTAO_ACCOUNT / ZENTAO_PASSWORD)从环境变量自动读取,无需在 mcp.json 中声明。
认证方式
优先使用 ZENTAO_TOKEN;如果未设置,则用 ZENTAO_ACCOUNT + ZENTAO_PASSWORD 自动登录获取 Token。
环境变量在 shared/env/common.env 中配置,由 zsh profile 链自动加载。
工具清单
| 模块 | 工具名 | 功能 |
|---|---|---|
| 用户 | zentao_get_my_profile |
获取当前用户信息 |
zentao_get_user |
获取用户详情 | |
zentao_list_users |
获取用户列表 | |
zentao_create_user |
创建用户 | |
zentao_update_user |
修改用户 | |
zentao_delete_user |
删除用户 | |
| 项目集 | zentao_list_programs |
获取项目集列表 |
zentao_get_program |
获取项目集详情 | |
zentao_create_program |
创建项目集 | |
zentao_update_program |
修改项目集 | |
zentao_delete_program |
删除项目集 | |
| 产品 | zentao_list_products |
获取产品列表 |
zentao_get_product |
获取产品详情 | |
zentao_create_product |
创建产品 | |
zentao_update_product |
修改产品 | |
zentao_delete_product |
删除产品 | |
| 产品计划 | zentao_list_plans |
获取计划列表 |
zentao_get_plan |
获取计划详情 | |
zentao_create_plan |
创建计划 | |
zentao_update_plan |
修改计划 | |
zentao_delete_plan |
删除计划 | |
zentao_link_plan_stories |
计划关联需求 | |
zentao_unlink_plan_stories |
计划取消关联需求 | |
zentao_link_plan_bugs |
计划关联 Bug | |
zentao_unlink_plan_bugs |
计划取消关联 Bug | |
| 发布 | zentao_list_project_releases |
获取项目发布列表 |
zentao_list_product_releases |
获取产品发布列表 | |
| 需求 | zentao_get_story |
获取需求详情 |
zentao_list_stories |
列出需求 | |
zentao_create_story |
创建需求 | |
zentao_update_story |
修改需求 | |
zentao_delete_story |
删除需求 | |
zentao_change_story |
变更需求 | |
| 项目 | zentao_list_projects |
获取项目列表 |
zentao_get_project |
获取项目详情 | |
zentao_create_project |
创建项目 | |
zentao_update_project |
修改项目 | |
zentao_delete_project |
删除项目 | |
| 执行 | zentao_list_executions |
获取执行列表 |
zentao_get_execution |
获取执行详情 | |
zentao_create_execution |
创建执行/迭代 | |
zentao_update_execution |
修改执行 | |
zentao_delete_execution |
删除执行 | |
| 版本 | zentao_list_project_builds |
获取项目版本列表 |
zentao_list_execution_builds |
获取执行版本列表 | |
zentao_get_build |
获取版本详情 | |
zentao_create_build |
创建版本 | |
zentao_update_build |
修改版本 | |
zentao_delete_build |
删除版本 | |
| Bug | zentao_get_bug |
获取 Bug 详情 |
zentao_list_bugs |
列出 Bug | |
zentao_create_bug |
创建 Bug | |
zentao_update_bug |
修改 Bug | |
zentao_delete_bug |
删除 Bug | |
| 任务 | zentao_get_task |
获取任务详情 |
zentao_list_tasks |
列出任务 | |
| 用例 | zentao_list_testcases |
获取用例列表 |
zentao_get_testcase |
获取用例详情 | |
zentao_create_testcase |
创建用例 | |
zentao_update_testcase |
修改用例 | |
zentao_delete_testcase |
删除用例 | |
| 测试单 | zentao_list_testtasks |
获取测试单列表 |
zentao_list_project_testtasks |
获取项目测试单 | |
zentao_get_testtask |
获取测试单详情 | |
| 反馈 | zentao_list_feedbacks |
获取反馈列表 |
zentao_get_feedback |
获取反馈详情 | |
zentao_create_feedback |
创建反馈 | |
zentao_update_feedback |
修改反馈 | |
zentao_delete_feedback |
删除反馈 | |
zentao_assign_feedback |
指派反馈 | |
zentao_close_feedback |
关闭反馈 | |
| 工单 | zentao_list_tickets |
获取工单列表 |
zentao_get_ticket |
获取工单详情 | |
zentao_create_ticket |
创建工单 | |
zentao_update_ticket |
修改工单 | |
zentao_delete_ticket |
删除工单 |
本地测试
cd ~/.cc-switch/mcp-servers/zentao
# 需确保 ZENTAO_BASE_URL / ZENTAO_ACCOUNT / ZENTAO_PASSWORD 已在环境中
node src/index.js
启动后通过 stdio 收发 MCP 协议消息。验证日志会打到 stderr。
注意
- 仅支持禅道 v18+ REST API
- 错误会以
isError: true的形式返回,文本里包含具体原因
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.