zentao-bug-server-mcp

禅道 Bug MCP 服务器 — 让 AI 编程助手直接管理禅道 Bug 全生命周期（查看/创建/解决/关闭/激活/指派）。

English documentation: README.en.md

安装

npx -y zentao-bug-server-mcp

前置条件

1. 可访问的禅道实例（支持 REST API /api.php/v1，禅道 15.x+）
2. 具备 Bug 读写权限的账号

环境变量

| 变量 | 必填 | 说明 | |------|------|------| | ZENTAO_URL | 是 | 禅道地址，如 http://zentao.example.com（兼容 ZENTAO_BASE_URL） | | ZENTAO_ACCOUNT | 二选一 | 登录账号（与密码配合；Token 过期时自动重登） | | ZENTAO_PASSWORD | 二选一 | 登录密码 | | ZENTAO_TOKEN | 二选一 | 已有 Token；未提供时用账号密码自动登录获取 |

配置

Cursor

在 ~/.cursor/mcp.json 中添加：

{
  "mcpServers": {
    "zentao-bug": {
      "command": "npx",
      "args": ["-y", "zentao-bug-server-mcp"],
      "env": {
        "ZENTAO_URL": "http://your-zentao.example.com",
        "ZENTAO_ACCOUNT": "your-account",
        "ZENTAO_PASSWORD": "your-password"
      },
      "description": "禅道 Bug 管理（9 tools）"
    }
  }
}

Claude Code

claude mcp add --transport stdio --scope user zentao-bug \
  --env ZENTAO_URL=http://your-zentao.example.com \
  --env ZENTAO_ACCOUNT=your-account \
  --env ZENTAO_PASSWORD=your-password \
  -- npx -y zentao-bug-server-mcp

可用工具

| 工具 | 说明 | |------|------| | zentao_list_products | 列出所有产品 | | zentao_list_bugs | 查询 Bug 列表（支持过滤/翻页） | | zentao_get_bug | 获取 Bug 详情 | | zentao_create_bug | 创建 Bug | | zentao_resolve_bug | 解决 Bug（active→resolved） | | zentao_close_bug | 关闭 Bug（resolved→closed） | | zentao_activate_bug | 激活 Bug（重新打开） | | zentao_assign_bug | 指派 Bug | | zentao_delete_bug | 删除 Bug（危险操作） |

状态流转

active → resolved → closed
   ↑                    |
   +---- activate <-----+

不能从 active 直接 close，必须先 resolve。

常用字段

| 字段 | 值 | |------|-----| | severity | 1=致命, 2=严重, 3=一般, 4=轻微 | | pri | 1=最高, 2=较高, 3=中, 4=低 | | type | codeerror / ui / compatibility / security / performance / other | | resolution | fixed / bydesign / duplicate / notrepro / willnotfix / postponed |

本地开发

cd zentao-bug-server-mcp
npm install
# Windows PowerShell
$env:ZENTAO_URL='http://your-zentao.example.com'
$env:ZENTAO_ACCOUNT='your-account'
$env:ZENTAO_PASSWORD='your-password'
node index.js

测试

# 仅协议测试（dummy 凭据）
npm test

# 含真实 API
$env:ZENTAO_URL='...'
$env:ZENTAO_ACCOUNT='...'
$env:ZENTAO_PASSWORD='...'
npm test

License

MIT