{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_puxqnxf6jtn7","handle":"zentao-mcp-v1","url":"https://wellknown.network/agents/zentao-mcp-v1","links":{"self":"https://wellknown.network/agents/zentao-mcp-v1/record.json","html":"https://wellknown.network/agents/zentao-mcp-v1","markdown":"https://wellknown.network/agents/zentao-mcp-v1/record.md","api":"https://wellknown.network/api/v1/agents/zentao-mcp-v1","status":"https://wellknown.network/api/v1/agents/zentao-mcp-v1/status","claim":"https://wellknown.network/agents/zentao-mcp-v1/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/zentao-mcp-v1/claim.json","badge":"https://wellknown.network/agents/zentao-mcp-v1/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:zentao-mcp-v1","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"zentao-mcp-v1","summary":"禅道 (ZenTao) V1.0 REST API MCP 服务器","description":"# ZenTao MCP Server (V1.0)\n\n禅道（ZenTao）**V1.0 REST API** 的 MCP（Model Context Protocol）服务器，覆盖官方 V1.0 API 手册全部 **97 个接口**，让 Claude 等 AI 助手直接查询与操作禅道的项目、需求、任务、Bug、用例等数据。\n\n## 简介\n\n- **全量覆盖**：Token、部门、用户、项目集、产品、产品计划、发布、需求、项目、版本、执行、任务、Bug、用例、测试单、反馈、工单 —— 17 个模块 97 个接口\n- **规范驱动**：`docs/zentao-v1-openapi.json` 由脚本从[官方 API 手册](https://www.zentao.net/book/api/2309.html)第 2 章自动生成（可重复执行），FastMCP 据此自动注册全部工具\n- **自动登录**：配置禅道账号密码后，服务端自动获取/续期 Token，MCP 客户端零配置接入；也可回退为客户端 Token 头透传\n- **Streamable HTTP**：以 HTTP 服务方式部署，支持远程与多客户端共享\n\n技术栈：Python ≥3.10、[FastMCP](https://gofastmcp.com) 3.x、httpx。\n\n## 快速开始\n\n### 1. 安装\n\n```bash\ngit clone <本仓库地址> && cd zentao-mcp-v1.0\nuv venv && uv pip install --python .venv/bin/python -e . --group dev\n# 或 pip: python -m venv .venv && .venv/bin/pip install -e .\n```\n\n### 2. 配置\n\n复制 `config.example.yaml` 为 `config.yaml`（已被 .gitignore 排除），填写：\n\n```yaml\nbase_url: \"http://您的禅道域名/api.php/v1\"   # 必填\naccount: \"您的禅道账号\"                       # 自动登录（推荐）\npassword: \"您的禅道密码\"\n```\n\n> 注意：`spec_path` 默认为相对当前工作目录的 `docs/zentao-v1-openapi.json`，请从仓库根目录启动；也可在配置或环境变量（`ZENTAO_MCP_SPEC_PATH`）中指定绝对路径。\n\n所有配置项均可用环境变量覆盖：`ZENTAO_MCP_BASE_URL` / `ZENTAO_MCP_ACCOUNT` / `ZENTAO_MCP_PASSWORD` / `ZENTAO_MCP_HOST` / `ZENTAO_MCP_PORT` 等。\n\n### 3. 运行\n\n```bash\ncp config.example.yaml config.yaml  # 编辑后\n.venv/bin/python -m zentao_mcp --config config.yaml\n# 默认监听 0.0.0.0:9091，MCP 端点 http://127.0.0.1:9091/mcp\n```\n\n## 客户端接入\n\n**自动登录模式（推荐）**——客户端只需 URL：\n\n```json\n{\n  \"mcpServers\": {\n    \"zentao-v1\": {\n      \"url\": \"http://127.0.0.1:9091/mcp\"\n    }\n  }\n}\n```\n\n**Token 透传模式**（未配置账号密码时；先用 `get_token` 工具或 `curl -X POST {base_url}/tokens` 获取 Token）：\n\n```json\n{\n  \"mcpServers\": {\n    \"zentao-v1\": {\n      \"url\": \"http://127.0.0.1:9091/mcp\",\n      \"headers\": { \"token\": \"您的Token\" }\n    }\n  }\n}\n```\n\n## Docker 部署\n\n```bash\ndocker build -t zentao-mcp-v1 .\ndocker run -d -p 9091:9091 \\\n  -e ZENTAO_MCP_BASE_URL=http://您的禅道域名/api.php/v1 \\\n  -e ZENTAO_MCP_ACCOUNT=您的账号 \\\n  -e ZENTAO_MCP_PASSWORD=您的密码 \\\n  zentao-mcp-v1\n```\n\n## 工具清单（97…","publisher":{"name":"leslie","url":null},"homepage":"https://www.zentao.net","repository":null,"version":"1.0.1","license":null,"protocols":["mcp"],"tags":["mcp","zentao","fastmcp","model-context-protocol","api"],"pricing":null,"endpoints":[{"url":"pypi:zentao-mcp-v1","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"data.apis","name":"API Access","confidence":0.814,"provenance":"derived"}],"categories":["data"],"language":"fr"},"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-mcp-v1","registry":"pypi","observedAt":"2026-09-10T16:24:34.923Z","publishedAt":"2026-08-19T03:16:12.879787Z","latestVersion":"1.0.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"zentao-mcp-v1","url":"https://pypi.org/project/zentao-mcp-v1/","firstSeenAt":"2026-09-10T16:23:50.383Z","fetchedAt":"2026-09-10T16:23:50.383Z","normalizedAt":"2026-09-10T16:23:50.383Z"}]},"firstSeenAt":"2026-09-10T16:23:50.383Z","updatedAt":"2026-09-10T16:24:34.923Z"}