zentao-v1-mcp

本项目是基于禅道 RESTful API v1 的 MCP 服务器，运行后通过 stdio 为 agent 提供一组小而明确的工具，用于读取禅道数据，并以受保护的方式创建或更新版本。

English documentation: README.en.md

快速开始

安装

npm install -g zentao-v1-mcp

配置

创建示例配置：

zentao-v1-mcp init-config

默认配置文件位置：

• Windows: %APPDATA%\zentao-v1-mcp\config.json
• Linux/macOS: ~/.config/zentao-v1-mcp/config.json

示例文件替换为实际环境配置：

{
  "base_url": "https://zentao.example.com",
  "account": "your-account",
  "password": "your-password",
  "timeout_seconds": 20
}

配置完毕后进行登录测试，确认配置正确：

zentao-v1-mcp validate-config --login

MCP 客户端配置示例

{
  "mcpServers": {
    "zentao-v1": {
      "command": "npx",
      "args": ["-y", "zentao-v1-mcp"],
      "env": {
        "ZENTAO_BASE_URL": "https://zentao.example.com",
        "ZENTAO_ACCOUNT": "your-account",
        "ZENTAO_PASSWORD": "your-password"
      }
    }
  }
}

进一步阅读

• 使用指南：完整工具列表、按执行查询 Bug、写操作安全等高级用法。
• 开发说明：第一版边界、本地验证命令、模块布局等开发者背景。
• 设计文档：禅道 v1 MCP 第一版完整设计。