{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_ea38rgxezgct","handle":"zentao-bugfix-mcp","url":"https://wellknown.network/agents/zentao-bugfix-mcp","links":{"self":"https://wellknown.network/agents/zentao-bugfix-mcp/record.json","html":"https://wellknown.network/agents/zentao-bugfix-mcp","markdown":"https://wellknown.network/agents/zentao-bugfix-mcp/record.md","api":"https://wellknown.network/api/v1/agents/zentao-bugfix-mcp","status":"https://wellknown.network/api/v1/agents/zentao-bugfix-mcp/status","claim":"https://wellknown.network/agents/zentao-bugfix-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/zentao-bugfix-mcp/claim.json","badge":"https://wellknown.network/agents/zentao-bugfix-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/zentao-bugfix-mcp/history","tools":"https://wellknown.network/api/v1/agents/zentao-bugfix-mcp/tools"},"ard":{"identifier":"urn:air::server:zentao-bugfix-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"zentao-bugfix-mcp","summary":"禅道 Bug MCP 服务 —— 在 Cursor 等客户端中查询待处理缺陷与 Bug 详情","description":"# 禅道 Bug MCP 服务\n\n在 Cursor 里通过 MCP 查禅道「指派给我的 Bug」、详情与截图。本服务**只对接禅道 API**；修复方案与改代码仍在 Cursor 同一对话中完成。\n\n**团队可选用两种 Cursor 接入方式（可同时存在）：**\n\n| 方式 | MCP 跑在哪里 | Cursor 配置要点 |\n|------|--------------|-----------------|\n| **A. 远程 HTTP** | 公司服务器（Docker / 裸机） | `url` + `headers`（`X-Zentao-*`） |\n| **B. PyPI + `uvx`（stdio）** | 每人本机子进程 | `command: uvx` + `env`（`ZENTAO_*`、`MCP_TRANSPORT=stdio`） |\n\n```\n方式 A：  禅道 API ←── MCP（服务器, streamable-http） ←── Cursor（url + headers）\n方式 B：  禅道 API ←── MCP（本机 uvx, stdio）        ←── Cursor（command + env）\n```\n\n- **方式 A**：适合统一运维、内网 HTTPS、集中 `MCP_AUTH_TOKEN`。  \n- **方式 B**：适合发布到 **PyPI** 后一条 `uvx` 命令接入，无需自建服务（禅道凭据在本机环境变量）。  \n\n详细发版与核对清单见：[docs/PYPI发布与双模式接入计划.md](docs/PYPI发布与双模式接入计划.md)。  \n示例配置（勿直接提交密码）：[docs/cursor-mcp.uvx.example.json](docs/cursor-mcp.uvx.example.json)、[docs/cursor-mcp.http.example.json](docs/cursor-mcp.http.example.json)。\n\n## 提供的工具\n\n| 工具 | 功能 | 参数 |\n|------|------|------|\n| `list_my_bugs` | 查询指派给我的待处理 Bug | `product_id`（可选） |\n| `get_bug_detail` | Bug 文字详情（含步骤、附件链接） | `bug_id` |\n| `get_bug_detail_with_images` | 同上 + 禅道 Token 拉取图片，供 Cursor 看图分析 | `bug_id` |\n\n---\n\n## 服务端部署\n\n### 方式一：Docker（推荐）\n\n```bash\n# 1. 克隆代码\ngit clone <repo-url> && cd zentao-bugfix-mcp\n\n# 2. 配置环境变量\ncp .env.example .env\n# 编辑 .env，填写认证令牌与禅道默认值（禅道也可仅由客户端 headers 传入）\n\n# 3. 启动\ndocker compose up -d\n\n# 4. 构建失败重新构建\n# 防止镜像内容和实际内容不对称\ndocker compose build --no-cache\n\ndocker compose up -d\n```\n\ndocker compose build --no-cache\n\n服务默认监听 `http://<服务器IP>:8000/mcp`。\n\n### 方式二：裸 Python\n\n```bash\npip install .\ncp .env.example .env    # 编辑 .env\nzentao-bugfix-mcp       # 启动\n```\n\n### 服务端环境变量\n\n| 变量                     | 必填 | 默认值            | 说明                                     |\n| ------------------------ | ---- | ----------------- | ---------------------------------------- |\n| `MCP_AUTH_TOKEN`         | 否   |                   | Bearer 认证令牌（公网部署时必须设置）    |\n| `MCP_PORT`               | 否   | `8000`            | 监听端口                                 |\n| `MCP_HOST`               | 否   | `0.0.0.0…","publisher":null,"homepage":"https://git.xhkjedu.com/xh/zentao_bugfix_mcp","repository":"https://git.xhkjedu.com/xh/zentao_bugfix_mcp","version":"0.1.0","license":null,"protocols":["mcp"],"tags":["bugfix","mcp","zentao"],"pricing":null,"endpoints":[{"url":"pypi:zentao-bugfix-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"code.debugging","name":"Debugging","confidence":1,"provenance":"derived"}],"categories":["code"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"zentao-bugfix-mcp","registry":"pypi","observedAt":"2026-11-04T05:22:47.952Z","publishedAt":"2026-04-10T08:39:01.559860Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"zentao-bugfix-mcp","url":"https://pypi.org/project/zentao-bugfix-mcp/","firstSeenAt":"2026-09-10T16:23:50.129Z","fetchedAt":"2026-11-04T05:22:19.579Z","normalizedAt":"2026-11-04T05:22:19.579Z"}]},"firstSeenAt":"2026-09-10T16:23:50.129Z","updatedAt":"2026-11-04T05:22:47.952Z"}