ZenTao MCP Server

MCP运维云端

提供方 godlewis

运维云端 未标注 Token 社区 / 第三方 Claude

一个基于Model Context Protocol (MCP)的服务器实现,用于让LLM能够操作禅道项目管理系统的API,支持项目管理、任务管理和批量操作等功能。

一句话选型结论

按资料字段整理

ZenTao MCP Server 属于运维云端类 MCP 服务器,传输方式未标注,Token,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式未标注 鉴权Token 部署方式支持远程部署
GitHub 星标 3 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

项目管理TypeScript本地部署任务管理批量操作API服务器

安装与配置

未标注 Token
上游未给出传输方式
  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
ZenTao MCP Server当前 未标注 未标注 支持远程部署 无 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方godlewis上游标注的维护方 godlewis
分类运维云端本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型支持远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

5.8 KB
来自项目仓库与上游目录的原文,未做删改

ZenTao MCP Server

一个基于 Model Context Protocol (MCP) 的服务器实现,用于让 LLM 能够操作禅道项目管理系统的 API。

✨ 核心功能

🔧 管理功能

  • ✅ 项目管理:获取项目列表、创建项目、查询项目详情
  • ✅ 任务管理:获取任务列表、创建任务、更新任务状态
  • ✅ 批量操作:批量创建任务,提高操作效率

💡 技术特性

  • 基于 TypeScript 开发,类型安全
  • 智能 LRU 缓存机制,减少 API 调用
  • 完善的错误处理和重试机制
  • 支持并发控制和速率限制
  • 完整的日志系统

🚀 快速开始

前置检查

  • [ ] 禅道服务器正在运行 (http://localhost)
  • [ ] 你有有效的禅道账号
  • [ ] Node.js >= 16.0.0 已安装

安装依赖```bash

npm install


### 构建项目```bash
npm run build

获取 Token

详细指南: `GETTING-TOKEN.md````bash

快速获取(推荐)

bash fetch-token.sh


### 启动服务器```bash
# Linux/Mac
./start-mcp.sh

# Windows
start-mcp.bat

启动成功标志:```
[INFO] 启动 ZenTao MCP 服务器...
[INFO] 连接验证成功
[INFO] 禅道版本: 开源版 21.7
[INFO] MCP 服务器已启动,等待连接...


---

## 🧪 测试

### 运行测试
**指南**: `TEST-REPORTS.md````bash
# 运行所有测试
npm test

# 分模块测试
npm run test:startup      # 启动测试
npm run test:tools        # 工具测试
npm run test:errors       # 错误处理测试
npm run test:performance  # 性能测试

# 生成覆盖率报告
npm run test:coverage

测试统计

  • 总测试用例: 31
  • 通过率: 83.9% (26/31)
  • 完全覆盖的工具: get_tasks
  • 缓存系统: 88.88% 覆盖率

📚 文档导航

核心文档

文档 说明
README.md 本文档,项目总览
GETTING-TOKEN.md Token 获取和管理指南
TEST-REPORTS.md 测试报告汇总

MCP 配置

文档 说明
CODEX-MCP-CONFIG.md Codex MCP 配置说明
codex-mcp-config-template.json 配置文件模板

项目配置

文件 说明
AGENTS.md OpenSpec 指令
CLAUDE.md Claude 项目指令
jest.config.js Jest 测试配置
.env.example 环境变量示例
tsconfig.json TypeScript 配置

🛠️ 可用脚本

测试脚本```bash

bash tests/run-all-tests.sh # 运行所有测试


### Token 管理```bash
bash fetch-token.sh          # 自动获取 Token
./update-token.sh            # 手动更新 Token
./diagnose-token.sh          # 诊断 Token 问题

开发脚本```bash

npm run build # 构建项目
npm run dev # 开发模式运行
npm run test:watch # 监视模式运行测试
npm run test:clean # 清理测试结果


---

## 🏗️ 项目结构```
zendao-mcp/
├── src/                      # 源代码
│   ├── tools/                # MCP 工具实现
│   │   ├── getTasks.ts       # ✅ 已测试
│   │   ├── getProjects.ts
│   │   ├── createProject.ts
│   │   ├── createTask.ts
│   │   ├── updateTaskStatus.ts
│   │   ├── getProjectById.ts
│   │   └── batchCreateTasks.ts
│   ├── client.ts             # API 客户端
│   ├── config.ts             # 配置管理
│   ├── types.ts              # 类型定义
│   └── utils/                # 工具函数
│       ├── cache.ts          # LRU 缓存
│       └── logger.ts         # 日志系统
├── tests/                    # 测试文件
│   ├── *.test.ts             # 测试用例
│   ├── helpers/              # 测试辅助
│   └── README.md             # 测试指南
├── dist/                     # 构建输出
├── docs/                     # 文档
└── *.md                      # 项目文档

🔌 API 工具

✅ 已验证工具

  • get_tasks - 获取任务列表
  • 支持分页:page, limit
  • 支持过滤:projectId, status, assignedTo
  • 缓存:5分钟 TTL,最多100项

🔄 受限工具(需Token)

以下工具代码完整,但需要有效的Token才能测试:
- get_projects - 获取项目列表
- get_project_by_id - 获取项目详情
- create_project - 创建项目
- create_task - 创建任务
- update_task_status - 更新任务状态
- batch_create_tasks - 批量创建任务


🐛 故障排除

Token 问题

现象: 401 Unauthorized 错误
解决: Token 已过期,重新获取```bash
bash fetch-token.sh
npm run build


详细指南: `GETTING-TOKEN.md`

### 构建失败
**现象**: TypeScript 编译错误
**解决**:```bash
npm run clean
npm run build

测试失败

现象: 测试用例失败
解决: 查看 `TEST-REPORTS.md`bash npm run test:startup # 先运行启动测试


📊 质量指标

代码质量

  • ✅ TypeScript 类型安全
  • ✅ 完整的错误处理
  • ✅ 单元测试覆盖
  • ✅ 并发安全保证

测试覆盖

  • 语句覆盖率: 38.06%
  • 分支覆盖率: 19.14%
  • 函数覆盖率: 41.50%
  • 缓存模块: 88.88%

目标: 90% 语句覆盖率

性能指标

  • ✅ 缓存命中率优化
  • ✅ 并发处理 (20 请求)
  • ✅ 响应时间 < 100ms
  • ✅ 内存使用合理

🤝 贡献指南

提交代码

  1. Fork 项目
  2. 创建功能分支
  3. 编写测试
  4. 运行测试: npm test
  5. 提交 PR

代码审查

  • [ ] 所有测试通过
  • [ ] 代码遵循规范
  • [ ] 包含必要注释
  • [ ] 更新相关文档

📄 许可证

ISC


🔗 相关链接

  • MCP 协议
  • 禅道 API 文档
  • Jest 测试框架
  • TypeScript 文档

维护者: Claude Code
版本: v1.0.0
最后更新: 2025-11-02

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
ZenTao MCP Server 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

ZenTao MCP Server 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

ZenTao MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

ZenTao MCP Server 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

ZenTao MCP Server 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

ZenTao MCP Server 能提供哪些能力?

资料显示能力标签包括 批量操作、API集成、TypeScript、Claude、项目管理。具体工具清单以官方文档为准。

ZenTao MCP Server 需要什么运行环境?

属于远程端点,不需要在本地装运行时。

ZenTao MCP Server 是本地还是远程?

它是远程端点,连服务地址即可。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。