MCP-Zentao

禅道项目管理系统的高级API集成包，提供任务管理、Bug跟踪等功能的完整封装，专为Cursor IDE设计的MCP扩展。

zentao '{"config":{"url":"https://your-zentao-url","username":"your-username","password":"your-password","apiVersion":"v1"},"name":"张三","age":25,"skills":["编程","设计"]}'

配置信息会被保存在用户目录下的.zentao/config.json文件中，后续使用时无需再次提供。

zentao '{"name":"张三","age":25,"skills":["编程","设计"]}'

zentao '{"config":{"url":"https://new-zentao-url","username":"new-username","password":"new-password","apiVersion":"v1"},"name":"张三","age":25,"skills":["编程","设计"]}'

- Windows:C:\Users\你的用户名\.zentao\config.json
- macOS/Linux:~/.zentao/config.json

- 支持配置信息的持久化存储
- 自动管理禅道API的认证信息
- 提供任务创建、更新、完成等功能
- 支持Bug跟踪和处理
- 完整的类型定义支持

- 配置文件中包含敏感信息，请确保文件权限设置正确
- 建议定期更新密码，以确保安全性
- 如遇到问题，可以删除配置文件重新配置

- 完整的禅道API封装
- 简单易用的接口设计
- 类型安全（TypeScript支持）
- 完善的错误处理
- 自动化的认证管理

不同于通用的数据库操作工具（如 mcp-mysql-server），本项目专注于提供：
- 禅道系统特定的业务功能
- 高级别的API抽象
- 完整的禅道工作流支持
- 开箱即用的禅道集成方案

git clone https://github.com/bigtian/mcp-zentao.git cd mcp-zentao

cp .env.example .env # 编辑 .env 文件，填入你的禅道系统配置

docker run -d \ --name mcp-zentao \ -p 3000:3000 \ -e ZENTAO_URL=your-zentao-url \ -e ZENTAO_USERNAME=your-username \ -e ZENTAO_PASSWORD=your-password \ -e ZENTAO_API_VERSION=v1 \ -v $(pwd)/logs:/app/logs \ mcp-zentao

{ "mcpServers": { "zentao": { "url": "http://localhost:3000" } } }

import { ZentaoAPI } from '@bigtian/mcp-zentao'; // 创建API实例 const api = new ZentaoAPI({ url: 'https://your-zentao-url', // 你的禅道系统URL username: 'your-username', // 用户名 password: 'your-password', // 密码 apiVersion: 'v1' // API版本，默认为v1 }); // 获取我的任务列表 async function getMyTasks() { try { const tasks = await api.getMyTasks(); console.log('我的任务:', tasks); } catch (error) { console.error('获取任务失败:', error); } } // 获取我的Bug列表 async function getMyBugs() { try { const bugs = await api.getMyBugs(); console.log('我的Bug:', bugs); } catch (error) { console.error('获取Bug失败:', error); } } // 完成任务 async function finishTask(taskId: number) { try { await api.finishTask(taskId); console.log('任务已完成'); } catch (error) { console.error('完成任务失败:', error); } } // 解决Bug async function resolveBug(bugId: number) { try { await api.resolveBug(bugId, { resolution: 'fixed', resolvedBuild: 'trunk', comment: '问题已修复' }); console.log('Bug已解决'); } catch (error) { console.error('解决Bug失败:', error); } }

constructor(config: { url: string; // 禅道系统URL username: string; // 用户名 password: string; // 密码 apiVersion?: string; // API版本，默认为v1 })

finishTask(taskId: number): Promise<void>

resolveBug(bugId: number, resolution: BugResolution): Promise<void>

- 解决指定ID的Bug
- 参数:

- bugId - Bug ID
- resolution - Bug解决方案

interface Task { id: number; name: string; status: string; pri: number; // ... 其他任务属性 } interface Bug { id: number; title: string; status: string; severity: number; // ... 其他Bug属性 } interface BugResolution { resolution: string; // 解决方案类型 resolvedBuild?: string; // 解决版本 duplicateBug?: number; // 重复Bug ID comment?: string; // 备注 }

- 确保提供正确的禅道系统URL和API版本
- 用户名和密码需要有相应的API访问权限
- 所有API调用都是异步的，需要使用async/await或Promise处理
- 错误处理建议使用try/catch进行捕获

- Node.js >= 14.0.0
- TypeScript >= 4.0.0

Integrates with the Backlog API to manage projects and issues.

Interact with the Backlog API to manage projects, issues, wikis, git repositories, and more.

An MCP server for interacting with the Backlog API, a project management and collaboration tool.

Integrate with the Goodday project management platform to manage projects, tasks, and users via its API.

Manage time tracking, projects, clients, and tasks using the Harvest API.

Integrates with Jira's REST API to manage issues programmatically.

Interact with the Taiga project management platform through an MCP bridge, allowing AI tools to manage project resources.

Interact with Yandex Tracker APIs for issue management and search.

Access the YouTrack REST API to manage projects and track issues in real-time.

Interact with task, doc, and project data in Dart, an AI-native project management tool