MCP Zentao

MCPAI代理

提供方 未标注

AI代理 HTTP · 远程 OAuth 授权 社区 / 第三方
查看接入方式

全面解析Zentaoapi Integration PackageMCP Server的核心功能、安装配置和实用案例。作为顶级Model Context Protocol服务器,Zentaoapi Integration Package能让AI助手访问实时数据、执行操作,为您提供更智能的工作体验和自动化解决方案。

一句话选型结论

按资料字段整理

MCP Zentao 属于AI代理类 MCP 服务器,HTTP · 远程,OAuth 授权,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

安装与配置

HTTP · 远程 OAuth 授权
连远程 HTTPS 端点,通常为 Streamable HTTP
npx mcp-zentao init

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

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

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Zentao当前 未标注 HTTP · 远程 远程部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

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

详细介绍

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

MCP-Zentao

禅道项目管理系统的高级API集成包,提供任务管理、Bug跟踪等功能的完整封装,专为Cursor IDE设计的MCP扩展。

安装```bash

npm install @bigtian/mcp-zentao -g


## 使用方法

### 首次使用(配置禅道信息)

首次使用时,需要提供禅道的配置信息:```bash
zentao '{"config":{"url":"https://your-zentao-url","username":"your-username","password":"your-password","apiVersion":"v1"},"name":"张三","age":25,"skills":["编程","设计"]}'

配置信息会被保存在用户目录下的 .zentao/config.json 文件中,后续使用时无需再次提供。

后续使用

配置完成后,只需要提供任务相关的信息即可:```bash
zentao '{"name":"张三","age":25,"skills":["编程","设计"]}'


### 更新配置

如果需要更新禅道配置信息,只需要再次提供 config 参数即可:```bash
zentao '{"config":{"url":"https://new-zentao-url","username":"new-username","password":"new-password","apiVersion":"v1"},"name":"张三","age":25,"skills":["编程","设计"]}'

配置文件位置

配置文件保存在用户目录下的 .zentao/config.json 文件中:

  • Windows: C:\Users\你的用户名\.zentao\config.json
  • macOS/Linux: ~/.zentao/config.json

功能特性

  • 支持配置信息的持久化存储
  • 自动管理禅道API的认证信息
  • 提供任务创建、更新、完成等功能
  • 支持Bug跟踪和处理
  • 完整的类型定义支持

注意事项

  • 配置文件中包含敏感信息,请确保文件权限设置正确
  • 建议定期更新密码,以确保安全性
  • 如遇到问题,可以删除配置文件重新配置

许可证

MIT

特点

  • 完整的禅道API封装
  • 简单易用的接口设计
  • 类型安全(TypeScript支持)
  • 完善的错误处理
  • 自动化的认证管理

与其他项目的区别

不同于通用的数据库操作工具(如 mcp-mysql-server),本项目专注于提供:

  1. 禅道系统特定的业务功能
  2. 高级别的API抽象
  3. 完整的禅道工作流支持
  4. 开箱即用的禅道集成方案

本地开发

  1. 克隆仓库```bash
    git clone https://github.com/bigtian/mcp-zentao.git
    cd mcp-zentao

2. 安装依赖```bash
npm install
  1. 运行测试```bash
    npm test

4. 构建项目```bash
npm run build

Docker 使用

使用 docker-compose(推荐)

  1. 复制环境变量模板并修改配置```bash
    cp .env.example .env

编辑 .env 文件,填入你的禅道系统配置


2. 启动服务```bash
docker-compose up -d
  1. 查看日志```bash
    docker-compose logs -f

### 手动使用 Docker

1. 构建镜像```bash
docker build -t mcp-zentao .
  1. 运行容器```bash
    docker run -d \
    --name mcp-zentao \
    -p 3000:3000 \
    -e ZENTAO_URL=your-zentao-url \
    -e ZENTAO_USERNAME=your-username \
    -e ZENTAO_PASSWORD=your-password \
    -e ZENTAO_API_VERSION=v1 \
    -v $(pwd)/logs:/app/logs \
    mcp-zentao

### 在 Cursor IDE 中配置

在 Cursor IDE 的配置文件中添加以下配置:```json
{
  "mcpServers": {
    "zentao": {
      "url": "http://localhost:3000"
    }
  }
}

基本使用```typescript

import { ZentaoAPI } from '@bigtian/mcp-zentao';

// 创建API实例
const api = new ZentaoAPI({
url: 'https://your-zentao-url', // 你的禅道系统URL
username: 'your-username', // 用户名
password: 'your-password', // 密码
apiVersion: 'v1' // API版本,默认为v1
});

// 获取我的任务列表
async function getMyTasks() {
try {
const tasks = await api.getMyTasks();
console.log('我的任务:', tasks);
} catch (error) {
console.error('获取任务失败:', error);
}
}

// 获取我的Bug列表
async function getMyBugs() {
try {
const bugs = await api.getMyBugs();
console.log('我的Bug:', bugs);
} catch (error) {
console.error('获取Bug失败:', error);
}
}

// 完成任务
async function finishTask(taskId: number) {
try {
await api.finishTask(taskId);
console.log('任务已完成');
} catch (error) {
console.error('完成任务失败:', error);
}
}

// 解决Bug
async function resolveBug(bugId: number) {
try {
await api.resolveBug(bugId, {
resolution: 'fixed',
resolvedBuild: 'trunk',
comment: '问题已修复'
});
console.log('Bug已解决');
} catch (error) {
console.error('解决Bug失败:', error);
}
}


## API文档

### ZentaoAPI 类

#### 构造函数```typescript
constructor(config: {
    url: string;          // 禅道系统URL
    username: string;     // 用户名
    password: string;     // 密码
    apiVersion?: string;  // API版本,默认为v1
})

方法

  1. getMyTasks(): Promise
    - 获取当前用户的任务列表
    - 返回: Promise

  2. getMyBugs(): Promise
    - 获取当前用户的Bug列表
    - 返回: Promise

  3. finishTask(taskId: number): Promise
    - 完成指定ID的任务
    - 参数: taskId - 任务ID
    - 返回: Promise

  4. resolveBug(bugId: number, resolution: BugResolution): Promise
    - 解决指定ID的Bug
    - 参数:

    • bugId - Bug ID
    • resolution - Bug解决方案
    • 返回: Promise

类型定义```typescript

interface Task {
id: number;
name: string;
status: string;
pri: number;
// ... 其他任务属性
}

interface Bug {
id: number;
title: string;
status: string;
severity: number;
// ... 其他Bug属性
}

interface BugResolution {
resolution: string; // 解决方案类型
resolvedBuild?: string; // 解决版本
duplicateBug?: number; // 重复Bug ID
comment?: string; // 备注
}
```

注意事项

  1. 确保提供正确的禅道系统URL和API版本
  2. 用户名和密码需要有相应的API访问权限
  3. 所有API调用都是异步的,需要使用async/await或Promise处理
  4. 错误处理建议使用try/catch进行捕获

开发环境

  • Node.js >= 14.0.0
  • TypeScript >= 4.0.0

贡献

欢迎提交Issue和Pull Request!

常见问题

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

在客户端按下面的安装命令接入:npx mcp-zentao init。装完在客户端配置里引用同一个包或端点。

MCP Zentao 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

MCP Zentao 收费吗?

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

MCP Zentao 需要 API Key 吗?

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

MCP Zentao 能提供哪些能力?

资料显示能力标签包括 任务跟踪、JavaScript、项目管理。具体工具清单以官方文档为准。

MCP Zentao 需要什么运行环境?

运行时为 Node.js;属于远程端点,不需要在本地装运行时。

MCP Zentao 是本地还是远程?

它是远程端点,连服务地址即可。传输方式为HTTP · 远程。

热门专题

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

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