ZenTao MCP Server
ZenTao MCP 서버 (API V1.0)
TypeScript + Node.js + @modelcontextprotocol/sdk 기반의 ZenTao MCP 서비스로, 다음 기능을 지원합니다:
로그인 초기화 (
initZentao)제품 조회 (
getProducts)내 버그 조회 (
getMyBugs)버그 상세 정보 조회 (
getBugDetail)버그 해결 (
resolveBug)버그 활성화 (
activateBug, 재오픈)
1. 환경 준비
npm install
cp .env.example .env.env 파일에 ZenTao 주소와 인증 정보를 설정하십시오 (런타임 시 initZentao를 통해 계정 비밀번호를 전달하는 것을 권장하며, 파일에 평문으로 저장하지 마십시오).
Related MCP server: ZenTao MCP Server
2. npm / npx 실행 (다른 머신 권장)
npm 패키지명: @wudidada/zentao-mcp-server (스코프 패키지; 실행 가능 명령 zentao-mcp-server).
요구 사항: Node.js >= 20. Linux/macOS는 시스템 curl 설치를 권장합니다 (기본 HTTP 백엔드는 curl).
2.1 명령줄 테스트 실행
npx -y @wudidada/zentao-mcp-serverHTTP 모드 예시:
MCP_TRANSPORT=http npx -y @wudidada/zentao-mcp-server2.2 Cursor mcp.json (stdio + 환경 변수)
프로젝트 또는 사용자 디렉토리의 .cursor/mcp.json에 다음과 같이 설정합니다:
{
"mcpServers": {
"zentao": {
"command": "npx",
"args": ["-y", "@wudidada/zentao-mcp-server"],
"env": {
"ZENTAO_BASE_URL": "http://your-host/zentao/api.php/v1",
"ZENTAO_ACCOUNT": "your_account",
"ZENTAO_PASSWORD": "your_password",
"ZENTAO_HTTP_BACKEND": "curl",
"LOG_LEVEL": "info"
}
}
}
}설정 변경 후 Cursor를 완전히 재시작하십시오. args의 패키지명을 고정 버전(예: @wudidada/zentao-mcp-server@1.0.1)으로 변경할 수도 있습니다.
2.3 관리자: npm 배포
npm run build
npm test
npm publish --access public최초 배포 전 npm login이 필요하며, package.json의 version이 중복되지 않았는지 확인하십시오.
소스 코드 저장소: https://github.com/wudidada/zentao-mcp-server
3. 시작 방법
stdio (로컬 IDE 권장)
npm run start:stdioHTTP/SSE (원격 접속)
npm run start:http기본 포트 3000, 상태 확인:
curl http://localhost:3000/healthz4. 빌드 및 테스트
npm run build
npm test5. MCP 도구 매개변수 설명
initZentao
baseUrl?: stringaccount: stringpassword?: stringtoken?: string
password와token중 하나를 선택하십시오.
getMyBugs
status?: "active" | "resolved" | "closed" | "all"(기본값active)productId?: number
getBugDetail
bugId: number
activateBug
bugId: numberassignedTo?: string(담당자, 계정)openedBuild?: string | string[](영향 버전, 문서는 배열; 미전송 시 기본값["trunk"])comment?: string
resolveBug
bugId: numberresolution.resolution: "fixed" | "notrepro" | "duplicate" | "bydesign" | "willnotfix" | "tostory" | "external"resolution.resolvedBuild?: string(해결책이fixed일 때 서버는 고정적으로trunk를 제출하며, 이 필드는 무시되어 일부 ZenTao 웹 페이지 표시 오류를 방지합니다)resolution.duplicateBug?: number(resolution=duplicate일 때 필수)resolution.comment?: string
6. 보안 및 운영 기준
로그는 기본적으로
password/token/authorization을 마스킹 처리합니다.기본 요청 타임아웃은
10s입니다.조회 인터페이스(GET)는 지수 백오프 재시도를 지원합니다.
HTTP 모드는
/healthz상태 확인을 제공합니다.ZENTAO_BASE_URL+ZENTAO_ACCOUNT+ (ZENTAO_PASSWORD또는ZENTAO_TOKEN)가 설정된 경우, 프로세스 시작 시 자동으로 로그인되어 매번initZentao를 호출할 필요가 없습니다.ZENTAO_HTTP_BACKEND:axios는 Node 내장 HTTP를 사용하며,curl은 시스템curl을 호출합니다. Windows가 아닌 환경에서는 기본적으로curl을 사용하여 일부 ZenTao 인스턴스의 'Node 클라이언트 +Token헤더 + GET' 장시간 응답 없음 문제를 회피합니다.
6.1 환경 변수 목록
변수 | 설명 |
| ZenTao API V1 루트 주소 (예: |
| 자동 로그인용 (비밀번호와 토큰 중 하나 선택) |
|
|
7. 프로젝트 구조
src/
adapters/ # 禅道 API V1.0 适配层
schemas/ # zod 参数校验
server/ # stdio/http 双入口
services/ # 领域服务
tools/ # MCP 工具实现8. 주의사항
현재 구현은 ZenTao API V1.0의 일반적인 REST 경로(
/tokens,/bugs,/products)를 기반으로 캡슐화되었습니다.버그 해결: 공식 v1 인터페이스는 **
POST /bugs/{id}/resolve**입니다(PUT이 아님). PUT을 잘못 사용할 경우 HTTP는 성공하지만 ZenTao 상태가 실제로 업데이트되지 않을 수 있습니다.ZenTao 인스턴스 경로 또는 인증 필드가 다를 경우
src/adapters/zentaoApiV1.ts에서 수정하십시오.
Available Tools
7 toolsactivateBugB
激活(重新打开)Bug,对应禅道 API v1:POST /bugs/{id}/active。适用于已解决/已关闭后重新激活。
Inputs: bugId (required), assignedTo, openedBuild, comment.
getBugDetailBRead-only
查看单个 bug 详情。
Inputs: bugId (required).
getMyBugsBRead-only
按状态与产品筛选我的 bug 列表。
Inputs: status, productId.
getProductsBRead-only
获取禅道产品列表。
Inputs: no named parameters.
healthCheckBRead-only
检查当前会话与服务可用性。
Inputs: no named parameters.
initZentaoC
初始化禅道连接并登录(支持 password 或 token)。
Inputs: baseUrl, account, password, token.
resolveBugC
提交 Bug 解决动作(fixed/notrepro/duplicate/...)。
Inputs: bugId (required), resolution (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose with no ambiguity. activateBug, resolveBug, getBugDetail, and getMyBugs handle different bug lifecycle stages and views, while getProducts, healthCheck, and initZentao cover separate administrative and setup functions. The descriptions make it easy to distinguish between tools like activateBug (reopen) and resolveBug (close with resolution).
The naming follows a mostly consistent verb_noun pattern with minor deviations. Tools like activateBug, getBugDetail, getMyBugs, getProducts, and resolveBug use clear action-object naming. However, healthCheck and initZentao deviate slightly by using compound nouns without verbs, though they remain readable and intuitive.
With 7 tools, this server is well-scoped for bug tracking and system management in ZenTao. Each tool earns its place by covering essential operations: bug lifecycle (activate, resolve, view), product listing, and system setup/health. The count is neither too sparse nor bloated, fitting the domain appropriately.
The tool set provides strong coverage for bug management with create, read, update (activate/resolve), and delete implied through resolution. Minor gaps exist, such as no explicit tool for creating bugs or managing other entities like tasks or users, but agents can work around this with the available tools for core workflows.
Maintenance
Related MCP Connectors
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Task and bug tracker for AI coding agents: 75 tools to file, triage and update work.
Manage Loom projects, tasks, bugs, defects, clients and phases from AI assistants
Related MCP Servers
- AlicenseAqualityNot gradedmaintenanceEnables direct integration with Zentao bug tracking systems through Cursor. Supports authentication, bug retrieval, searching, and listing operations for comprehensive bug management through natural language.57 npm-
- FlicenseBqualityNot gradedmaintenanceEnables interaction with ZenTao project management system through RESTful API v1. Supports bug tracking, project/product management, and automated token authentication for seamless integration.102-
- FlicenseAqualityBmaintenanceEnables interaction with ZenTao project management system through RESTful APIs. Supports listing products, managing bugs, viewing statistics, and filtering personal bug assignments through natural language.430 npm16-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Zentao bugs, requirements, and test cases through natural language interactions. It supports querying, creating, and updating various Zentao data entities including products, projects, and executions.12MIT