🚀 MCP-Zentao 项目文档

MCP-Zentao 是一款专为禅道系统深度集成设计的工具，具备任务管理、Bug 跟踪等核心功能，能高效助力团队项目协作，且具有良好的扩展性和定制性。

🚀 快速开始

安装完成后，在终端中运行：

npm start

打开浏览器，访问http://localhost:3000。按照界面提示登录或注册，即可开始使用 MCP-Zentao。

✨ 主要特性

核心功能

• 任务管理：支持创建、查看和完成任务。
• Bug 跟踪：提供 Bug 的报告、分配和解决功能。
• 项目管理：帮助团队协作，跟踪项目进度。
• 测试集成：与多种测试框架无缝集成。

技术特性

• API 支持：通过 RESTful API 接口实现数据交互。
• 插件系统：支持自定义插件扩展功能。
• UI 可定制性：提供高度可定制的用户界面，满足不同需求。

特点

• 高效性：优化的代码结构确保快速响应。
• 稳定性：经过严格测试，保证系统稳定运行。
• 扩展性：灵活的设计便于功能扩展和定制。

与其他项目区别

功能对比

优势

• 专为禅道设计：深度集成禅道系统，提供更好的使用体验。
• 灵活配置：支持高度定制，满足不同团队需求。

📦 安装指南

要在您的系统上安装 MCP-Zentao，请按照以下步骤操作：

1. 下载：从MCP-Zentao 官方页面下载最新版本的软件包。
2. 解压：将下载的压缩包解压到您选择的目录中。
3. 配置环境：根据安装指南设置必要的环境变量和依赖项。
4. 启动服务：运行启动脚本以开始 MCP-Zentao 服务。

💻 使用示例

基础用法

首次配置

1. 打开终端或命令提示符，进入解压后的目录。
2. 运行以下命令开始首次配置：

npm install

3. 安装完成后，运行初始设置脚本：

npx mcp-zentao init

4. 按照提示输入您的禅道系统 URL、用户名和密码。

后续使用

1. 启动服务：每次需要使用时，运行以下命令：

npm start

2. 打开浏览器，访问http://localhost:3000进入 MCP-Zentao 界面。

更新配置

若需更新配置，请参考配置文档。您可以通过编辑配置文件或重新运行初始化命令来完成更新：

npx mcp-zentao init

高级用法

API 使用示例

const { Task, Bug, BugResolution } = require('mcp-zentao');

// 创建一个新任务
const task = new Task({
    title: '完成用户故事',
    description: '实现新增功能模块'
});

// 提交任务
task.submit().then(() => {
    console.log('任务已提交');
}).catch(error => {
    console.error('提交失败:', error);
});

📚 详细文档

配置文件位置

默认情况下，配置文件位于~/.config/mcp-zentao/config.json。您可以在此文件中找到和修改禅道系统的连接信息。

配置指南

环境变量配置

MCP-Zentao 支持通过环境变量进行配置。请在项目根目录创建.env文件，并添加以下内容：

NODE_ENV=development
PORT=3000
ZENTAO_URL=http://your-zentao-instance

依赖管理

使用 npm 或 yarn 进行依赖管理：

• 使用 npm：

npm install

• 使用 yarn：

yarn install

本地开发

开发环境要求

• 操作系统：Linux, Windows, macOS
• Node.js 版本：>=14.0.0
• npm 版本：>=6.0.0
• 其他依赖：请参考开发者文档

开发流程

1. 克隆仓库：

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

2. 安装依赖：

npm install

3. 启动开发服务器：

npm run dev

4. 测试：运行单元测试和集成测试：

npm test

附录

命令行工具

MCP-Zentao 提供命令行工具mcp-cli，支持以下操作：

• init：初始化项目。
• start：启动服务。
• build：构建生产环境。
• test：运行测试用例。

术语表

• 禅道：指禅道系统，用于项目和任务管理的平台。

API 文档

类名和接口

• 类名：请参考MCP-Zentao SDK中的详细说明。
• 接口名：
  • Task：表示任务对象
  • Bug：表示 Bug 对象
  • BugResolution：表示 Bug 解决方式

🔧 技术细节

注意事项

1. 兼容性：确保您的禅道系统版本与 MCP-Zentao 兼容。
2. 数据同步：定期检查数据同步状态，避免数据丢失。
3. 权限管理：合理设置用户权限，确保系统安全。

常见问题

1. 无法启动服务？
   • 检查端口是否被占用。
   • 确保所有依赖已正确安装。
2. 连接禅道失败？
   • 核对禅道系统的 URL、用户名和密码。
   • 确保禅道系统正在运行且网络正常。

📄 许可证

MCP-Zentao 遵循MIT License，允许个人和商业用途。请仔细阅读许可协议以了解具体条款。

贡献指南

欢迎社区贡献！请参考贡献者文档了解如何参与开发。