@zzp123/mcp-zentao 1.18.8 → 1.18.10

package/dist/api/zentaoApi.js

@@ -55,7 +55,9 @@ export class ZentaoAPI {
         }
         catch (error) {
             if (axios.isAxiosError(error)) {
-                throw new Error(`请求失败: ${error.response?.data?.message || error.message}`);
+                const errData = error.response?.data;
+                const errMsg = typeof errData === 'object' ? JSON.stringify(errData) : (errData || error.message);
+                throw new Error(`请求失败: ${error.response?.status} - ${errMsg}`);
             }
             throw error;
         }
@@ -477,18 +479,18 @@ export class ZentaoAPI {
     }
     async getProductPlans(productId, branch, begin, end, status, parent) {
         try {
-            const data = {};
+            const params = {};
             if (branch !== undefined)
-                data.branch = branch;
+                params.branch = branch;
             if (begin)
-                data.begin = begin;
+                params.begin = begin;
             if (end)
-                data.end = end;
+                params.end = end;
             if (status)
-                data.status = status;
+                params.status = status;
             if (parent !== undefined)
-                data.parent = parent;
-            const response = await this.request('POST', `/products/${productId}/plans`, undefined, data);
+                params.parent = parent;
+            const response = await this.request('GET', `/products/${productId}/plans`, params);
             if (Array.isArray(response)) {
                 return response;
             }
@@ -505,7 +507,12 @@ export class ZentaoAPI {
     }
     async createStory(story) {
         try {
-            const response = await this.request('POST', '/stories', undefined, story);
+            // 禅道API要求：如果没有指定reviewer，需要设置needNotReview=true跳过评审
+            const requestData = {
+                ...story,
+                needNotReview: true
+            };
+            const response = await this.request('POST', '/stories', undefined, requestData);
             return response;
         }
         catch (error) {
@@ -532,7 +539,7 @@ export class ZentaoAPI {
     }
     async deletePlan(planId) {
         try {
-            const response = await this.request('DELETE', `/products/plans/${planId}`);
+            const response = await this.request('DELETE', `/productplans/${planId}`);
             return response;
         }
         catch (error) {
@@ -705,14 +712,8 @@ export class ZentaoAPI {
      */
     async changeStory(storyId, update) {
         try {
-            // 自动处理评审人问题
-            const updateData = { ...update };
-            // 如果用户没有设置评审人，也没有指定无需评审，则自动跳过评审
-            if (!updateData.reviewer && updateData.needNotReview !== true) {
-                updateData.needNotReview = true;
-            }
-            // 使用 PUT /stories/:id 接口
-            const response = await this.request('PUT', `/stories/${storyId}`, undefined, updateData);
+            // 使用 POST /stories/:id/change 接口（变更需求专用接口）
+            const response = await this.request('POST', `/stories/${storyId}/change`, undefined, update);
             return response;
         }
         catch (error) {

package/dist/index-dev.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"),
@@ -100,11 +98,11 @@ server.tool("getMyBugs", "获取我的Bug列表 - 固定查询指派给我的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)
@@ -225,29 +223,26 @@ server.tool("getProjectReleases", {
     };
 });
 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) }]
     };
@@ -258,8 +253,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) }]
     };
 });
 server.tool("getProjects", {
@@ -269,8 +273,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) }]
     };
 });
 server.tool("deleteTask", {
@@ -341,6 +347,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()