{"_id":"@einsteins/zentao-v1-mcp","name":"@einsteins/zentao-v1-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@einsteins/zentao-v1-mcp","version":"1.0.0","description":"MCP server for ZenTao RESTful API v1","license":"Apache-2.0","homepage":"https://github.com/xuansheep/zentao-v1-mcp#readme","bugs":{"url":"https://github.com/xuansheep/zentao-v1-mcp/issues"},"repository":{"type":"git","url":"git+https://github.com/xuansheep/zentao-v1-mcp.git"},"type":"module","main":"dist/cli.js","bin":{"zentao-v1-mcp":"dist/cli.js"},"scripts":{"build":"tsc -p tsconfig.json","test":"vitest run","smoke":"vitest run tests/smoke/stdio-smoke.test.ts","verify":"npm run build && npm test && npm run smoke && npm audit --audit-level=moderate && npm pack --dry-run","prepack":"npm run build","prepublishOnly":"npm run build && npm test && npm run smoke && npm audit --audit-level=moderate"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.24.0"},"devDependencies":{"@types/node":"^20.0.0","typescript":"^5.6.0","vitest":"^4.1.7"},"engines":{"node":">=20"},"publishConfig":{"access":"public"},"optionalDependencies":{"playwright":"^1.61.1"},"_id":"@einsteins/zentao-v1-mcp@1.0.0","gitHead":"f70822864a32faff4663d98bb2b9b3fed9cbde78","_nodeVersion":"22.22.2","_npmVersion":"10.9.7","dist":{"integrity":"sha512-j2Vrag3QcUDCZKybxTMIJaZIXJxQ0vG/qr4KajyOv2RYip8KgOKr0rWXLsF3fEXdIVMVyMHQQtBqc26KeSZB0w==","shasum":"c55c6bc8e8ad8f3a34173784192e7d1b9bdb09e1","tarball":"https://registry.npmjs.org/@einsteins/zentao-v1-mcp/-/zentao-v1-mcp-1.0.0.tgz","fileCount":124,"unpackedSize":434678,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIGmNMQqul+CQZSUztgYsEdN7qs7hpxxCupREWI9SsnwWAiAGCZPS8H65zzCOjDpEU33wNjySEfdYkHrIPonZUTmvpQ=="}]},"_npmUser":{"name":"einsteins","email":"einxuu@gmail.com"},"directories":{},"maintainers":[{"name":"einsteins","email":"einxuu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/zentao-v1-mcp_1.0.0_1783996835194_0.4057497618071786"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-14T02:40:35.025Z","1.0.0":"2026-07-14T02:40:35.380Z","modified":"2026-07-14T02:40:35.535Z"},"maintainers":[{"name":"einsteins","email":"einxuu@gmail.com"}],"description":"MCP server for ZenTao RESTful API v1","homepage":"https://github.com/xuansheep/zentao-v1-mcp#readme","repository":{"type":"git","url":"git+https://github.com/xuansheep/zentao-v1-mcp.git"},"bugs":{"url":"https://github.com/xuansheep/zentao-v1-mcp/issues"},"license":"Apache-2.0","readme":"# zentao-v1-mcp\r\n\r\n本项目是基于禅道 RESTful API v1 的 MCP 服务器，运行后通过 stdio 为 agent 提供一组小而明确的工具，用于读取禅道数据，并以受保护的方式创建或更新版本。\r\n\r\nEnglish documentation: [README.en.md](README.en.md)\r\n\r\n## 项目来源\r\n\r\n本项目是基于 [hustbeta/zentao-v1-mcp](https://github.com/hustbeta/zentao-v1-mcp) 修改的 Apache-2.0 衍生版本，由 `xuansheep` 维护并通过 npm scope `@einsteins` 发布。相对上游的主要修改说明见 [NOTICE](NOTICE)。\r\n\r\n## 快速开始\r\n\r\n### 安装\r\n\r\n```bash\r\nnpm install -g @einsteins/zentao-v1-mcp\r\n```\r\n\r\n### 配置\r\n\r\n创建示例配置：\r\n\r\n```bash\r\nzentao-v1-mcp init-config\r\n```\r\n\r\n默认配置文件位置：\r\n\r\n- Windows: `%APPDATA%\\zentao-v1-mcp\\config.json`\r\n- Linux/macOS: `~/.config/zentao-v1-mcp/config.json`\r\n\r\n示例文件替换为实际环境配置：\r\n\r\n```json\r\n{\r\n  \"base_url\": \"https://zentao.example.com\",\r\n  \"account\": \"your-account\",\r\n  \"password\": \"your-password\",\r\n  \"timeout_seconds\": 20\r\n}\r\n```\r\n\r\n配置完毕后进行登录测试，确认配置正确：\r\n\r\n```bash\r\nzentao-v1-mcp validate-config --login\r\n```\r\n\r\n## MCP 客户端配置示例\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"zentao-v1\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"@einsteins/zentao-v1-mcp\"],\r\n      \"env\": {\r\n        \"ZENTAO_BASE_URL\": \"https://zentao.example.com\",\r\n        \"ZENTAO_ACCOUNT\": \"your-account\",\r\n        \"ZENTAO_PASSWORD\": \"your-password\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n## 进一步阅读\r\n\r\n- [使用指南](doc/usage/README.md)：完整工具列表、按执行查询 Bug、写操作安全等高级用法。\r\n- [开发说明](doc/dev/README.md)：第一版边界、本地验证命令、模块布局等开发者背景。\r\n- [设计文档](doc/design/zentao-v1-mcp-design.md)：禅道 v1 MCP 第一版完整设计。\r\n","readmeFilename":"README.md","_rev":"1-ef33b28b1fff963c90423e5fc4fffa4f"}