@zzp123/mcp-zentao 1.18.9 → 1.18.11

package/dist/index-qa.js

@@ -3,6 +3,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { ZentaoAPI } from './api/zentaoApi.js';
 import { loadConfig, saveConfig } from './config.js';
+import { withApi } from './mcpHelpers.js';
 import { interactiveInitTransport, startServerTransport } from './serverTransport.js';
 // 解析命令行参数
 const args = process.argv.slice(2);
@@ -33,6 +34,7 @@ const server = new McpServer({
 });
 // Initialize ZentaoAPI instance
 let zentaoApi = null;
+const getApi = () => zentaoApi;
 export default async function main(params) {
     // 如果传入了配置信息，就保存它
     if (params.config) {
@@ -55,24 +57,20 @@ server.tool("initZentao", {}, async ({}) => {
 });
 server.tool("getMyTasks", {
     status: z.enum(['wait', 'doing', 'done', 'all']).optional()
-}, async ({ status }) => {
-    if (!zentaoApi)
-        throw new Error("Please initialize Zentao API first");
-    const tasks = await zentaoApi.getMyTasks(status);
+}, withApi(getApi, async (api, { status }) => {
+    const tasks = await api.getMyTasks(status);
     return {
         content: [{ type: "text", text: JSON.stringify(tasks, null, 2) }]
     };
-});
+}));
 server.tool("getTaskDetail", {
     taskId: z.number()
-}, async ({ taskId }) => {
-    if (!zentaoApi)
-        throw new Error("Please initialize Zentao API first");
-    const task = await zentaoApi.getTaskDetail(taskId);
+}, withApi(getApi, async (api, { taskId }) => {
+    const task = await api.getTaskDetail(taskId);
     return {
         content: [{ type: "text", text: JSON.stringify(task, null, 2) }]
     };
-});
+}));
 server.tool("getMyBugs", "获取我的Bug列表 - 固定查询指派给我的Bug（status='assigntome'），固定每页20条", {
     productId: z.number().optional().describe("产品ID，默认使用第二个产品"),
     page: z.number().optional().describe("页码，从1开始，默认为1"),
@@ -148,11 +146,11 @@ server.tool("getProductBugs", "获取指定产品的Bug列表 - 支持多种状
 });
 server.tool("getBugDetail", {
     bugId: z.number(),
-    fields: z.enum(['basic', 'detail', 'full']).optional().describe(`
-字段级别：
-- basic: 基本信息（id, title, status, severity, pri等核心字段）
-- detail: 详细信息（包含steps步骤，但不包含files/cases/linkBugs等关联数据）
-- full: 完整信息（包含所有字段，默认值）
+    fields: z.enum(['basic', 'detail', 'full']).optional().describe(`
+字段级别：
+- basic: 基本信息（id, title, status, severity, pri等核心字段）
+- detail: 详细信息（包含steps步骤，但不包含files/cases/linkBugs等关联数据）
+- full: 完整信息（包含所有字段，默认值）
         `.trim())
 }, async ({ bugId, fields }) => {
     if (!zentaoApi)
@@ -197,29 +195,26 @@ server.tool("resolveBug", {
     };
 });
 server.tool("getStoryDetail", "获取需求详情 - 支持软件需求(story)和用户需求(requirement)，自动识别类型", {
-    storyId: z.number().describe("需求ID（可以是story或requirement类型）"),
-    fields: z.enum(['basic', 'detail', 'full']).optional().describe(`
-字段级别：
-- basic: 基本信息（id, title, status, stage, pri等核心字段）
-- detail: 详细信息（包含spec和verify，但不包含executions/tasks/stages/children等关联数据）
-- full: 完整信息（包含所有字段，默认值）
-        `.trim())
-}, async ({ storyId, fields }) => {
+    storyId: z.number().describe("需求ID（可以是story或requirement类型）")
+}, async ({ storyId }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
-    const story = await zentaoApi.getStoryDetail(storyId, fields);
-    // 添加说明信息
+    const story = await zentaoApi.getStoryDetail(storyId, 'basic');
+    // 只返回基本信息
     const result = {
-        fieldLevel: fields || 'full',
-        story: story
+        id: story.id,
+        title: story.title,
+        status: story.status,
+        stage: story.stage,
+        pri: story.pri,
+        type: story.type,
+        category: story.category,
+        product: story.product,
+        productName: story.productName,
+        openedBy: story.openedBy,
+        openedDate: story.openedDate,
+        assignedTo: story.assignedTo
     };
-    // 根据字段级别添加提示
-    if (fields === 'basic') {
-        result.note = '仅显示基本信息，如需完整内容请使用 fields=detail 或 fields=full';
-    }
-    else if (fields === 'detail') {
-        result.note = '显示详细信息但不包含关联数据（executions/tasks/stages/children），如需完整内容请使用 fields=full';
-    }
     return {
         content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
     };

package/dist/index.js

@@ -162,11 +162,11 @@ server.tool("getProductBugs", "获取指定产品的Bug列表 - 支持多种状
 // Add getBugDetail tool
 server.tool("getBugDetail", {
     bugId: z.number(),
-    fields: z.enum(['basic', 'detail', 'full']).optional().describe(`
-字段级别：
-- basic: 基本信息（id, title, status, severity, pri等核心字段）
-- detail: 详细信息（包含steps步骤，但不包含files/cases/linkBugs等关联数据）
-- full: 完整信息（包含所有字段，默认值）
+    fields: z.enum(['basic', 'detail', 'full']).optional().describe(`
+字段级别：
+- basic: 基本信息（id, title, status, severity, pri等核心字段）
+- detail: 详细信息（包含steps步骤，但不包含files/cases/linkBugs等关联数据）
+- full: 完整信息（包含所有字段，默认值）
         `.trim())
 }, async ({ bugId, fields }) => {
     if (!zentaoApi)
@@ -268,8 +268,19 @@ server.tool("getProductPlans", {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
     const plans = await zentaoApi.getProductPlans(productId, branch, begin, end, status, parent);
+    // 精简返回字段
+    const simplifyPlan = (p) => ({
+        id: p.id,
+        title: p.title,
+        status: p.status,
+        begin: p.begin,
+        end: p.end,
+        stories: p.stories,
+        bugs: p.bugs
+    });
+    const simplified = plans.map(simplifyPlan);
     return {
-        content: [{ type: "text", text: JSON.stringify(plans, null, 2) }]
+        content: [{ type: "text", text: JSON.stringify(simplified, null, 2) }]
     };
 });
 // Add createTask tool
@@ -441,29 +452,26 @@ server.tool("getProjectReleases", {
 });
 // Add getStoryDetail tool
 server.tool("getStoryDetail", "获取需求详情 - 支持软件需求(story)和用户需求(requirement)，自动识别类型", {
-    storyId: z.number().describe("需求ID（可以是story或requirement类型）"),
-    fields: z.enum(['basic', 'detail', 'full']).optional().describe(`
-字段级别：
-- basic: 基本信息（id, title, status, stage, pri等核心字段）
-- detail: 详细信息（包含spec和verify，但不包含executions/tasks/stages/children等关联数据）
-- full: 完整信息（包含所有字段，默认值）
-        `.trim())
-}, async ({ storyId, fields }) => {
+    storyId: z.number().describe("需求ID（可以是story或requirement类型）")
+}, async ({ storyId }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
-    const story = await zentaoApi.getStoryDetail(storyId, fields);
-    // 添加说明信息
+    const story = await zentaoApi.getStoryDetail(storyId, 'basic');
+    // 只返回基本信息
     const result = {
-        fieldLevel: fields || 'full',
-        story: story
+        id: story.id,
+        title: story.title,
+        status: story.status,
+        stage: story.stage,
+        pri: story.pri,
+        type: story.type,
+        category: story.category,
+        product: story.product,
+        productName: story.productName,
+        openedBy: story.openedBy,
+        openedDate: story.openedDate,
+        assignedTo: story.assignedTo
     };
-    // 根据字段级别添加提示
-    if (fields === 'basic') {
-        result.note = '仅显示基本信息，如需完整内容请使用 fields=detail 或 fields=full';
-    }
-    else if (fields === 'detail') {
-        result.note = '显示详细信息但不包含关联数据（executions/tasks/stages/children），如需完整内容请使用 fields=full';
-    }
     return {
         content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
     };
@@ -519,8 +527,17 @@ server.tool("getProjectExecutions", {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
     const executions = await zentaoApi.getProjectExecutions(projectId);
+    // 只返回基本字段
+    const simplified = executions.map((e) => ({
+        id: e.id,
+        name: e.name,
+        status: e.status,
+        begin: e.begin,
+        end: e.end,
+        progress: e.progress
+    }));
     return {
-        content: [{ type: "text", text: JSON.stringify(executions, null, 2) }]
+        content: [{ type: "text", text: JSON.stringify(simplified, null, 2) }]
     };
 });
 // Add createPlan tool
@@ -555,8 +572,10 @@ server.tool("getProjects", {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
     const projects = await zentaoApi.getProjects(page, limit);
+    // 只返回 id 和 name 字段
+    const simplified = projects.map((p) => ({ id: p.id, name: p.name }));
     return {
-        content: [{ type: "text", text: JSON.stringify(projects, null, 2) }]
+        content: [{ type: "text", text: JSON.stringify(simplified, null, 2) }]
     };
 });
 // Add changeStory tool
@@ -603,10 +622,10 @@ server.tool("changeStory", "需求变更 - 支持软件需求(story)和用户需
         verify: z.string().optional(),
         // 备注
         comment: z.string().optional()
-    }).describe(`更新需求（使用 PUT 接口）
-
-此工具使用标准的"修改需求其他字段"接口（PUT /stories/:id），支持修改29个字段。
-自动处理评审人问题，无需手动设置 needNotReview。
+    }).describe(`更新需求（使用 PUT 接口）
+
+此工具使用标准的"修改需求其他字段"接口（PUT /stories/:id），支持修改29个字段。
+自动处理评审人问题，无需手动设置 needNotReview。
         `.trim())
 }, async ({ storyId, update }) => {
     if (!zentaoApi)
@@ -755,6 +774,7 @@ server.tool("deleteProject", { projectId: z.number() }, async ({ projectId }) =>
 server.tool("createExecution", {
     projectId: z.number(), project: z.number(), name: z.string(), code: z.string(),
     begin: z.string(), end: z.string(), days: z.number().optional(), lifetime: z.string().optional(),
+    products: z.array(z.number()).describe("关联产品ID数组"),
     PO: z.string().optional(), PM: z.string().optional(), QD: z.string().optional(),
     RD: z.string().optional(), teamMembers: z.array(z.string()).optional(),
     desc: z.string().optional(), acl: z.string().optional(), whitelist: z.array(z.string()).optional()
@@ -830,11 +850,11 @@ server.tool("createRequirement", "创建用户需求(requirement) - 用户需求
 });
 server.tool("getRequirementDetail", "获取用户需求详情 - 用户需求的专用接口，提供更好的语义化", {
     requirementId: z.number().describe("用户需求ID"),
-    fields: z.enum(['basic', 'detail', 'full']).optional().describe(`
-字段级别：
-- basic: 基本信息（id, title, status, stage, pri等核心字段）
-- detail: 详细信息（包含spec和verify，但不包含executions/tasks/stages/children等关联数据）
-- full: 完整信息（包含所有字段，默认值）
+    fields: z.enum(['basic', 'detail', 'full']).optional().describe(`
+字段级别：
+- basic: 基本信息（id, title, status, stage, pri等核心字段）
+- detail: 详细信息（包含spec和verify，但不包含executions/tasks/stages/children等关联数据）
+- full: 完整信息（包含所有字段，默认值）
         `.trim())
 }, async ({ requirementId, fields }) => {
     if (!zentaoApi)
@@ -872,11 +892,11 @@ server.tool("changeRequirement", "用户需求变更 - 用户需求的专用接
         assignedTo: z.string().optional(),
         reviewer: z.array(z.string()).optional(),
         comment: z.string().optional()
-    }).describe(`
-更新用户需求（使用 PUT /stories/:id 接口）
-
-此工具使用标准的"修改需求其他字段"接口(PUT /stories/:id),支持修改多个字段。
-自动处理评审人问题,无需手动设置 needNotReview。
+    }).describe(`
+更新用户需求（使用 PUT /stories/:id 接口）
+
+此工具使用标准的"修改需求其他字段"接口(PUT /stories/:id),支持修改多个字段。
+自动处理评审人问题,无需手动设置 needNotReview。
         `.trim())
 }, async ({ requirementId, update }) => {
     if (!zentaoApi)

package/dist/roleConfig.d.ts

@@ -2,17 +2,13 @@ export type Role = 'pm' | 'qa' | 'dev' | 'admin' | 'all';
 export declare const TOOL_CATEGORIES: {
     init: string[];
     story: string[];
-    storyReadonly: string[];
     product: string[];
     plan: string[];
     program: string[];
     feedback: string[];
     bug: string[];
-    bugResolve: string[];
-    bugReadonly: string[];
     testcase: string[];
     task: string[];
-    taskReadonly: string[];
     project: string[];
     execution: string[];
     build: string[];

package/dist/roleConfig.js

@@ -9,7 +9,6 @@ export const TOOL_CATEGORIES = {
         'changeStory', 'changeRequirement', 'deleteStory', 'deleteRequirement',
         'getRequirementDetail', 'getProductStories', 'addStoryComment'
     ],
-    storyReadonly: ['getStoryDetail', 'getRequirementDetail', 'getProductStories'],
     // 产品管理（仅产品经理）
     product: [
         'getProducts', 'getProductDetail', 'createProduct',
@@ -36,8 +35,6 @@ export const TOOL_CATEGORIES = {
         'getMyBugs', 'getProductBugs', 'getBugDetail', 'createBug',
         'updateBug', 'deleteBug', 'resolveBug', 'addBugComment'
     ],
-    bugResolve: ['getMyBugs', 'getBugDetail', 'resolveBug', 'addBugComment'],
-    bugReadonly: ['getMyBugs', 'getProductBugs', 'getBugDetail'],
     // 测试用例（仅测试）
     testcase: [
         'getProductTestCases', 'getTestCaseDetail', 'createTestCase',
@@ -48,7 +45,6 @@ export const TOOL_CATEGORIES = {
         'getMyTasks', 'getTaskDetail', 'createTask',
         'updateTask', 'finishTask', 'deleteTask', 'addTaskComment'
     ],
-    taskReadonly: ['getMyTasks', 'getTaskDetail'],
     // 项目管理（仅开发）
     project: [
         'getProjects', 'getProjectDetail', 'createProject',
@@ -86,39 +82,38 @@ export const TOOL_CATEGORIES = {
 };
 // 角色权限配置
 export const ROLE_PERMISSIONS = {
-    // 产品经理：需求、产品、计划、项目集、评论
+    // 产品经理：初始化+项目+需求+执行+计划+评论+用户
     pm: [
-        ...TOOL_CATEGORIES.init,
-        ...TOOL_CATEGORIES.story,
-        ...TOOL_CATEGORIES.product,
-        ...TOOL_CATEGORIES.plan,
-        ...TOOL_CATEGORIES.program,
-        ...TOOL_CATEGORIES.bugReadonly,
-        ...TOOL_CATEGORIES.taskReadonly,
-        ...TOOL_CATEGORIES.comment,
-        ...TOOL_CATEGORIES.utility
-    ],
-    // 测试工程师：Bug、测试用例、评论
+        'initZentao',
+        'getProjects',
+        'createStory',
+        'getStoryDetail',
+        'changeStory',
+        'deleteStory',
+        'getProjectExecutions',
+        'getProductPlans',
+        'linkStoriesToPlan',
+        'createExecution',
+        'deleteExecution',
+        'deletePlan',
+        'getComments',
+        'addComment',
+        'getUsers',
+        'getMyProfile'
+    ],
+    // 测试工程师：初始化+缺陷与用例
     qa: [
-        ...TOOL_CATEGORIES.init,
-        ...TOOL_CATEGORIES.bug,
-        ...TOOL_CATEGORIES.testcase,
-        ...TOOL_CATEGORIES.storyReadonly,
-        ...TOOL_CATEGORIES.taskReadonly,
-        ...TOOL_CATEGORIES.comment,
-        ...TOOL_CATEGORIES.utility
+        'initZentao',
+        'createBug',
+        'createTestCase',
+        'getMyBugs'
     ],
-    // 开发工程师：任务、Bug解决、项目、迭代、版本构建、评论
+    // 开发工程师：初始化+缺陷处理
     dev: [
-        ...TOOL_CATEGORIES.init,
-        ...TOOL_CATEGORIES.task,
-        ...TOOL_CATEGORIES.bugResolve,
-        ...TOOL_CATEGORIES.project,
-        ...TOOL_CATEGORIES.execution,
-        ...TOOL_CATEGORIES.build,
-        ...TOOL_CATEGORIES.storyReadonly,
-        ...TOOL_CATEGORIES.comment,
-        ...TOOL_CATEGORIES.utility
+        'initZentao',
+        'getMyBugs',
+        'getBugDetail',
+        'resolveBug'
     ],
     // 管理员：所有工具
     admin: [

package/dist/types/zentao.d.ts

@@ -397,6 +397,7 @@ export interface CreateExecutionRequest {
     code: string;
     begin: string;
     end: string;
+    products: number[];
     days?: number;
     lifetime?: string;
     PO?: string;

package/json-args.js

@@ -1,27 +1,27 @@
-#!/usr/bin/env node
-
-// 获取命令行参数中的 JSON 字符串
-const jsonArg = process.argv[2];
-
-if (!jsonArg) {
-    process.stderr.write('[ERROR] 请提供 JSON 参数\n');
-    process.exit(1);
-}
-
-try {
-    // 解析 JSON 字符串
-    const params = JSON.parse(jsonArg);
-
-    // 导入并执行主程序
-    import('./dist/index.js')
-        .then(module => {
-            module.default(params);
-        })
-        .catch(error => {
-            process.stderr.write('[ERROR] 执行失败: ' + String(error) + '\n');
-            process.exit(1);
-        });
-} catch (error) {
-    process.stderr.write('[ERROR] JSON 解析失败: ' + String(error) + '\n');
-    process.exit(1);
+#!/usr/bin/env node
+
+// 获取命令行参数中的 JSON 字符串
+const jsonArg = process.argv[2];
+
+if (!jsonArg) {
+    process.stderr.write('[ERROR] 请提供 JSON 参数\n');
+    process.exit(1);
+}
+
+try {
+    // 解析 JSON 字符串
+    const params = JSON.parse(jsonArg);
+
+    // 导入并执行主程序
+    import('./dist/index.js')
+        .then(module => {
+            module.default(params);
+        })
+        .catch(error => {
+            process.stderr.write('[ERROR] 执行失败: ' + String(error) + '\n');
+            process.exit(1);
+        });
+} catch (error) {
+    process.stderr.write('[ERROR] JSON 解析失败: ' + String(error) + '\n');
+    process.exit(1);
 } 

package/package.json

@@ -1,75 +1,75 @@
-{
-    "name": "@zzp123/mcp-zentao",
-    "version": "1.18.9",
-    "description": "禅道项目管理系统的高级API集成包 - 完整版，包含所有94个工具。另有产品经理、测试工程师、开发工程师专用精简版本可选",
-    "main": "dist/index.js",
-    "type": "module",
-    "types": "dist/index.d.ts",
-    "bin": {
-        "zentao": "dist/index.js",
-        "zentao-dev": "dist/index-dev.js",
-        "zentao-pm": "dist/index-pm.js",
-        "zentao-qa": "dist/index-qa.js"
-    },
-    "files": [
-        "dist",
-        "README.md",
-        "CHANGELOG.md",
-        "json-args.js",
-        "scripts"
-    ],
-    "scripts": {
-        "build": "tsc",
-        "watch": "tsc -w",
-        "lint": "eslint src/**/*.ts",
-        "test": "jest",
-        "test:watch": "jest --watch",
-        "test:manual": "ts-node test/manual-test.ts",
-        "prepublishOnly": "npm run test && npm run build",
-        "start": "node json-args.js",
-        "upload:clipboard": "node scripts/upload-clipboard-image.js",
-        "upload:clipboard:py": "python scripts/upload-clipboard-image.py"
-    },
-    "keywords": [
-        "mcp",
-        "zentao",
-        "禅道",
-        "任务管理",
-        "项目管理",
-        "bug跟踪",
-        "api集成",
-        "cursor-ide",
-        "typescript"
-    ],
-    "author": "zzp123",
-    "license": "MIT",
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/yourusername/mcp-zentao.git"
-    },
-    "dependencies": {
-        "@modelcontextprotocol/sdk": "^1.6.1",
-        "axios": "^1.6.7",
-        "chalk": "^4.1.2",
-        "form-data": "^4.0.4",
-        "fs": "^0.0.1-security",
-        "table": "^6.8.1",
-        "yargs": "^17.7.2"
-    },
-    "devDependencies": {
-        "@types/form-data": "^2.2.1",
-        "@types/jest": "^29.5.12",
-        "@types/node": "^20.11.19",
-        "@types/table": "^6.3.2",
-        "@typescript-eslint/eslint-plugin": "^7.0.1",
-        "@typescript-eslint/parser": "^7.0.1",
-        "eslint": "^8.56.0",
-        "jest": "^29.7.0",
-        "ts-jest": "^29.1.2",
-        "ts-node": "^10.9.2",
-        "typescript": "^5.9.3"
-    },
-    "publishConfig": {
-        "access": "public"
-    }
-}
+{
+    "name": "@zzp123/mcp-zentao",
+    "version": "1.18.11",
+    "description": "禅道项目管理系统的高级API集成包 - 完整版，包含所有94个工具。另有产品经理、测试工程师、开发工程师专用精简版本可选",
+    "main": "dist/index.js",
+    "type": "module",
+    "types": "dist/index.d.ts",
+    "bin": {
+        "zentao": "dist/index.js",
+        "zentao-dev": "dist/index-dev.js",
+        "zentao-pm": "dist/index-pm.js",
+        "zentao-qa": "dist/index-qa.js"
+    },
+    "files": [
+        "dist",
+        "README.md",
+        "CHANGELOG.md",
+        "json-args.js",
+        "scripts"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "watch": "tsc -w",
+        "lint": "eslint src/**/*.ts",
+        "test": "jest",
+        "test:watch": "jest --watch",
+        "test:manual": "ts-node test/manual-test.ts",
+        "prepublishOnly": "npm run test && npm run build",
+        "start": "node json-args.js",
+        "upload:clipboard": "node scripts/upload-clipboard-image.js",
+        "upload:clipboard:py": "python scripts/upload-clipboard-image.py"
+    },
+    "keywords": [
+        "mcp",
+        "zentao",
+        "禅道",
+        "任务管理",
+        "项目管理",
+        "bug跟踪",
+        "api集成",
+        "cursor-ide",
+        "typescript"
+    ],
+    "author": "zzp123",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/yourusername/mcp-zentao.git"
+    },
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.6.1",
+        "axios": "^1.6.7",
+        "chalk": "^4.1.2",
+        "form-data": "^4.0.4",
+        "fs": "^0.0.1-security",
+        "table": "^6.8.1",
+        "yargs": "^17.7.2"
+    },
+    "devDependencies": {
+        "@types/form-data": "^2.2.1",
+        "@types/jest": "^29.5.12",
+        "@types/node": "^20.11.19",
+        "@types/table": "^6.3.2",
+        "@typescript-eslint/eslint-plugin": "^7.0.1",
+        "@typescript-eslint/parser": "^7.0.1",
+        "eslint": "^8.56.0",
+        "jest": "^29.7.0",
+        "ts-jest": "^29.1.2",
+        "ts-node": "^10.9.2",
+        "typescript": "^5.9.3"
+    },
+    "publishConfig": {
+        "access": "public"
+    }
+}