禅道 MCP Server

让 AI 助手能够直接管理禅道中的 Bug、需求和测试用例。通过 MCP (Model Context Protocol)，你可以用自然语言与 AI 交流来查询、创建、更新和关闭各种禅道数据。

✨ 功能特性

Bug 管理

• 📋 获取 Bug 列表（支持按状态筛选）
• 🔍 查看 Bug 详情
• ➕ 创建新 Bug
• ✅ 解决 Bug（标记为已修复）
• 🔒 关闭 Bug
• 🔄 激活 Bug（重新打开）
• ✔️ 确认 Bug

需求管理

• 📋 获取需求列表（支持按状态筛选）
• 🔍 查看需求详情
• ➕ 创建新需求
• 🔒 关闭需求
• 🔄 激活需求

测试用例管理

• 📋 获取测试用例列表
• 🔍 查看测试用例详情
• ➕ 创建测试用例
• ✏️ 修改测试用例
• 🗑️ 删除测试用例

其他功能

• 📦 获取产品列表
• 📁 获取项目列表
• 🔄 获取执行（迭代）列表

🚀 快速开始

方式一：使用 npx（推荐）

无需安装，直接在 MCP 客户端配置中使用：

Cursor 配置

编辑 ~/.cursor/mcp.json（Windows: %USERPROFILE%\.cursor\mcp.json）：

{
  "mcpServers": {
    "zentao": {
      "command": "npx",
      "args": ["-y", "@tytt/zentao-mcp"],
      "env": {
        "ZENTAO_URL": "https://your-zentao-server.com",
        "ZENTAO_ACCOUNT": "your_username",
        "ZENTAO_PASSWORD": "your_password",
        "ZENTAO_SKIP_SSL": "true"
      }
    }
  }
}

Claude Desktop 配置

编辑 claude_desktop_config.json：

{
  "mcpServers": {
    "zentao": {
      "command": "npx",
      "args": ["-y", "@tytt/zentao-mcp"],
      "env": {
        "ZENTAO_URL": "https://your-zentao-server.com",
        "ZENTAO_ACCOUNT": "your_username",
        "ZENTAO_PASSWORD": "your_password",
        "ZENTAO_SKIP_SSL": "true"
      }
    }
  }
}

方式二：全局安装

npm install -g @tytt/zentao-mcp

然后在 MCP 配置中使用：

{
  "mcpServers": {
    "zentao": {
      "command": "zentao-mcp",
      "env": {
        "ZENTAO_URL": "https://your-zentao-server.com",
        "ZENTAO_ACCOUNT": "your_username",
        "ZENTAO_PASSWORD": "your_password",
        "ZENTAO_SKIP_SSL": "true"
      }
    }
  }
}

方式三：从源码运行

1. 克隆项目并安装依赖：

git clone https://github.com/Tytt/zentao-mcp.git
cd zentao-mcp
npm install
npm run build

2. 在 MCP 配置中使用本地路径：

{
  "mcpServers": {
    "zentao": {
      "command": "node",
      "args": ["/path/to/zentao-mcp/dist/index.js"],
      "env": {
        "ZENTAO_URL": "https://your-zentao-server.com",
        "ZENTAO_ACCOUNT": "your_username",
        "ZENTAO_PASSWORD": "your_password",
        "ZENTAO_SKIP_SSL": "true"
      }
    }
  }
}

⚙️ 环境变量说明

💬 使用示例

配置完成后，你可以用自然语言与 AI 交流来管理禅道：

Bug 相关

> "帮我看下有哪些 Bug 还没修复"
> "查看 Bug #123 的详细信息"
> "我已经修复了 Bug #123，帮我关闭它"
> "在产品 1 创建一个 Bug：登录页面按钮点击无响应"

需求相关

> "列出产品 1 的需求"
> "有哪些正在进行中的需求？"
> "创建一个新需求：用户登录功能优化"

测试用例相关

> "帮我看下有哪些测试用例"
> "创建一个登录功能的测试用例"
> "删除测试用例 #5"

🛠️ 可用工具列表

Bug 管理

需求管理

测试用例管理

产品和项目

📝 状态说明

Bug 状态

需求状态

测试用例状态

⚠️ 注意事项

1. API 版本：本项目基于禅道 REST API v1 开发，适用于禅道 12.x 及以上版本
2. 权限：确保配置的账号有足够的权限进行相应操作
3. SSL 证书：如果禅道使用自签名证书，需要设置 ZENTAO_SKIP_SSL=true
4. 密码安全：不要将配置文件提交到公开的版本控制系统

🔧 发布到 npm（维护者）

# 登录 npm
npm login

# 发布
npm publish --access public

📄 License

MIT