zentao-bugfix-mcp

# 禅道 Bug MCP 服务 在 Cursor 里通过 MCP 查禅道「指派给我的 Bug」、详情与截图。本服务**只对接禅道 API**；修复方案与改代码仍在 Cursor 同一对话中完成。 **团队可选用两种 Cursor 接入方式（可同时存在）：** | 方式 | MCP 跑在哪里 | Cursor 配置要点 | |------|--------------|-----------------| | **A. 远程 HTTP** | 公司服务器（Docker / 裸机） | `url` + `headers`（`X-Zentao-*`） | | **B. PyPI + `uvx`（stdio）** | 每人本机子进程 | `command: uvx` + `env`（`ZENTAO_*`、`MCP_TRANSPORT=stdio`） | ``` 方式 A： 禅道 API ←── MCP（服务器, streamable-http） ←── Cursor（url + headers） 方式 B： 禅道 API ←── MCP（本机 uvx, stdio） ←── Cursor（command + env） ``` - **方式 A**：适合统一运维、内网 HTTPS、集中 `MCP_AUTH_TOKEN`。 - **方式 B**：适合发布到 **PyPI** 后一条 `uvx` 命令接入，无需自建服务（禅道凭据在本机环境变量）。 详细发版与核对清单见：[docs/PYPI发布与双模式接入计划.md](docs/PYPI发布与双模式接入计划.md)。 示例配置（勿直接提交密码）：[docs/cursor-mcp.uvx.example.json](docs/cursor-mcp.uvx.example.json)、[docs/cursor-mcp.http.example.json](docs/cursor-mcp.http.example.json)。 ## 提供的工具 | 工具 | 功能 | 参数 | |------|------|------| | `list_my_bugs` | 查询指派给我的待处理 Bug | `product_id`（可选） | | `get_bug_detail` | Bug 文字详情（含步骤、附件链接） | `bug_id` | | `get_bug_detail_with_images` | 同上 + 禅道 Token 拉取图片，供 Cursor 看图分析 | `bug_id` | --- ## 服务端部署 ### 方式一：Docker（推荐） ```bash # 1. 克隆代码 git clone <repo-url> && cd zentao-bugfix-mcp # 2. 配置环境变量 cp .env.example .env # 编辑 .env，填写认证令牌与禅道默认值（禅道也可仅由客户端 headers 传入） # 3. 启动 docker compose up -d # 4. 构建失败重新构建 # 防止镜像内容和实际内容不对称 docker compose build --no-cache docker compose up -d ``` docker compose build --no-cache 服务默认监听 `http://<服务器IP>:8000/mcp`。 ### 方式二：裸 Python ```bash pip install . cp .env.example .env # 编辑 .env zentao-bugfix-mcp # 启动 ``` ### 服务端环境变量 | 变量 | 必填 | 默认值 | 说明 | | ------------------------ | ---- | ----------------- | ---------------------------------------- | | `MCP_AUTH_TOKEN` | 否 | | Bearer 认证令牌（公网部署时必须设置） | | `MCP_PORT` | 否 | `8000` | 监听端口 | | `MCP_HOST` | 否 | `0.0.0.0…