@chenyingxian/zentao-mcp

禅道 MCP Server，面向禅道 RESTful API v1 和部分旧版 JSON / 表单路由。

适用于自托管禅道环境。当前主要覆盖个人任务、任务详情、工时日志、周总结、构建、测试单和发版任务预览等常用流程。

安装

npm install -g @chenyingxian/zentao-mcp

也可以不全局安装，直接通过 npx 运行：

npx @chenyingxian/zentao-mcp

文档

• 配置说明
• 工具说明
• English README

快速配置

在 MCP 客户端中配置环境变量：

ZENTAO_BASE_URL=https://zentao.example.com
ZENTAO_ACCOUNT=your-account
ZENTAO_PASSWORD=your-password

也可以直接使用已签发的 v1 token：

ZENTAO_BASE_URL=https://zentao.example.com
ZENTAO_TOKEN=your-token

如果不希望密码直接展示在 MCP 客户端配置里，可以把真实配置写到本地配置文件：

ZENTAO_BASE_URL=https://zentao.example.com
ZENTAO_ACCOUNT=your-account
ZENTAO_PASSWORD=your-password
ZENTAO_TIMEOUT_MS=15000

然后 MCP 客户端只配置文件路径：

{
  "mcpServers": {
    "zentao": {
      "command": "npx",
      "args": ["-y", "@chenyingxian/zentao-mcp@latest"],
      "env": {
        "ZENTAO_CONFIG_FILE": "/path/to/zentao.env"
      }
    }
  }
}

环境变量会覆盖 ZENTAO_CONFIG_FILE 文件里的同名配置。

MCP 客户端示例

{
  "mcpServers": {
    "zentao": {
      "command": "npx",
      "args": ["-y", "@chenyingxian/zentao-mcp@latest"],
      "env": {
        "ZENTAO_CONFIG_FILE": "/path/to/zentao.env"
      }
    }
  }
}

获取 Token

全局安装后可以使用：

zentao-mcp-get-token --base-url "https://zentao.example.com" --account "your-account" --password "your-password"

源码目录中可以使用：

./scripts/get-token.sh --base-url "https://zentao.example.com" --account "your-account" --password "your-password"

注意事项

• 支持禅道 RESTful API v1；部分能力会使用禅道旧版 JSON / 表单路由。
• 创建构建、创建测试单等写操作默认 dry_run=true，需要显式传 false 才会真实创建。
• 不要提交或发布真实 .env、账号、密码、token、内网域名或业务数据。