@zzp123/mcp-zentao 1.18.2 → 1.18.4

package/dist/index.js

@@ -4,6 +4,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { z } from "zod";
 import { ZentaoAPI } from './api/zentaoApi.js';
 import { loadConfig, saveConfig } from './config.js';
+import { withApi } from './mcpHelpers.js';
 // 解析命令行参数
 const args = process.argv.slice(2);
 let configData = null;
@@ -14,15 +15,12 @@ if (configIndex !== -1 && configIndex + 1 < args.length) {
         // 获取 --config 后面的 JSON 字符串并解析
         const jsonStr = args[configIndex + 1];
         configData = JSON.parse(jsonStr);
-        console.log('成功解析配置数据:', configData);
         // 如果配置数据中包含 config 对象，则保存配置
         if (configData.config) {
-            console.log('正在保存配置...');
             saveConfig(configData.config);
         }
     }
     catch (error) {
-        console.error('配置解析失败:', error);
         process.exit(1);
     }
 }
@@ -33,11 +31,10 @@ const server = new McpServer({
 });
 // Initialize ZentaoAPI instance
 let zentaoApi = null;
+const getApi = () => zentaoApi;
 export default async function main(params) {
-    console.log('接收到的参数:', params);
     // 如果传入了配置信息，就保存它
     if (params.config) {
-        console.log('保存新的配置信息...');
         saveConfig(params.config);
     }
 }
@@ -58,25 +55,21 @@ server.tool("initZentao", {}, async ({}) => {
 // Add getMyTasks tool
 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) }]
     };
-});
+}));
 // Add getTaskDetail tool
 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) }]
     };
-});
+}));
 // Add getProducts tool
 server.tool("getProducts", "获取产品列表 - 只返回核心字段（id, 名称, 负责人）", {
     fields: z.enum(['basic', 'default', 'full']).optional().describe("返回字段级别：'basic'(id/名称/状态)、'default'(+负责人/创建人,默认)、'full'(完整字段)")
@@ -564,76 +557,58 @@ server.tool("getProjects", {
     };
 });
 // Add changeStory tool
-server.tool("changeStory", "需求变更 - 支持软件需求(story)和用户需求(requirement)，自动识别类型。支持对象或JSON字符串格式", {
+server.tool("changeStory", "需求变更 - 支持软件需求(story)和用户需求(requirement)，自动识别类型", {
     storyId: z.number().describe("需求ID（可以是story或requirement类型）"),
-    update: z.union([
-        z.object({
-            // 基本信息
-            title: z.string().optional(),
-            product: z.number().optional(),
-            parent: z.number().optional(),
-            module: z.number().optional(),
-            branch: z.number().optional(),
-            plan: z.union([z.number(), z.array(z.number())]).optional(),
-            type: z.string().optional(),
-            // 来源信息
-            source: z.string().optional(),
-            sourceNote: z.string().optional(),
-            // 分类与优先级
-            category: z.string().optional(),
-            pri: z.number().optional(),
-            estimate: z.number().optional(),
-            // 状态与阶段
-            stage: z.string().optional(),
-            status: z.string().optional(),
-            // 关键词与标识
-            keywords: z.string().optional(),
-            color: z.string().optional(),
-            grade: z.number().optional(),
-            // 人员相关
-            mailto: z.array(z.string()).optional(),
-            reviewer: z.array(z.string()).optional().describe("评审人员列表（通常为必填，除非设置needNotReview=true跳过评审）"),
-            assignedTo: z.string().optional(),
-            closedBy: z.string().optional(),
-            feedbackBy: z.string().optional(),
-            // 关闭相关
-            closedReason: z.enum(['done', 'subdivided', 'duplicate', 'postponed', 'willnotdo', 'cancel', 'bydesign']).optional(),
-            duplicateStory: z.number().optional(),
-            // 评审相关
-            needNotReview: z.boolean().optional().describe("是否跳过评审，如果不提供reviewer则应设置为true"),
-            // 通知相关
-            notifyEmail: z.string().optional(),
-            // 描述内容
-            spec: z.string().optional(),
-            verify: z.string().optional(),
-            // 备注
-            comment: z.string().optional()
-        }),
-        z.string()
-    ]).describe(`更新需求（使用 PUT 接口）
+    update: z.object({
+        // 基本信息
+        title: z.string().optional(),
+        product: z.number().optional(),
+        parent: z.number().optional(),
+        module: z.number().optional(),
+        branch: z.number().optional(),
+        plan: z.union([z.number(), z.array(z.number())]).optional(),
+        type: z.string().optional(),
+        // 来源信息
+        source: z.string().optional(),
+        sourceNote: z.string().optional(),
+        // 分类与优先级
+        category: z.string().optional(),
+        pri: z.number().optional(),
+        estimate: z.number().optional(),
+        // 状态与阶段
+        stage: z.string().optional(),
+        status: z.string().optional(),
+        // 关键词与标识
+        keywords: z.string().optional(),
+        color: z.string().optional(),
+        grade: z.number().optional(),
+        // 人员相关
+        mailto: z.array(z.string()).optional(),
+        reviewer: z.array(z.string()).optional().describe("评审人员列表（通常为必填，除非设置needNotReview=true跳过评审）"),
+        assignedTo: z.string().optional(),
+        closedBy: z.string().optional(),
+        feedbackBy: z.string().optional(),
+        // 关闭相关
+        closedReason: z.enum(['done', 'subdivided', 'duplicate', 'postponed', 'willnotdo', 'cancel', 'bydesign']).optional(),
+        duplicateStory: z.number().optional(),
+        // 评审相关
+        needNotReview: z.boolean().optional().describe("是否跳过评审，如果不提供reviewer则应设置为true"),
+        // 通知相关
+        notifyEmail: z.string().optional(),
+        // 描述内容
+        spec: z.string().optional(),
+        verify: z.string().optional(),
+        // 备注
+        comment: z.string().optional()
+    }).describe(`更新需求（使用 PUT 接口）
 
 此工具使用标准的"修改需求其他字段"接口（PUT /stories/:id），支持修改29个字段。
 自动处理评审人问题，无需手动设置 needNotReview。
-
-支持对象或JSON字符串格式。
         `.trim())
 }, async ({ storyId, update }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
-    // 如果 update 是字符串，尝试解析为对象
-    let updateData;
-    if (typeof update === 'string') {
-        try {
-            updateData = JSON.parse(update);
-        }
-        catch (error) {
-            throw new Error(`Invalid JSON string: ${error instanceof Error ? error.message : 'Unknown error'}`);
-        }
-    }
-    else {
-        updateData = update;
-    }
-    const story = await zentaoApi.changeStory(storyId, updateData);
+    const story = await zentaoApi.changeStory(storyId, update);
     return {
         content: [{ type: "text", text: JSON.stringify(story, null, 2) }]
     };
@@ -878,49 +853,32 @@ server.tool("getRequirementDetail", "获取用户需求详情 - 用户需求的
 });
 server.tool("changeRequirement", "用户需求变更 - 用户需求的专用接口，提供更好的语义化", {
     requirementId: z.number().describe("用户需求ID"),
-    update: z.union([
-        z.object({
-            title: z.string().optional(),
-            product: z.number().optional(),
-            parent: z.number().optional(),
-            module: z.number().optional(),
-            pri: z.number().optional(),
-            category: z.string().optional(),
-            spec: z.string().optional(),
-            verify: z.string().optional(),
-            source: z.string().optional(),
-            sourceNote: z.string().optional(),
-            estimate: z.number().optional(),
-            keywords: z.string().optional(),
-            assignedTo: z.string().optional(),
-            reviewer: z.array(z.string()).optional(),
-            comment: z.string().optional()
-        }),
-        z.string().describe("JSON字符串格式的更新内容")
-    ]).describe(`
+    update: z.object({
+        title: z.string().optional(),
+        product: z.number().optional(),
+        parent: z.number().optional(),
+        module: z.number().optional(),
+        pri: z.number().optional(),
+        category: z.string().optional(),
+        spec: z.string().optional(),
+        verify: z.string().optional(),
+        source: z.string().optional(),
+        sourceNote: z.string().optional(),
+        estimate: z.number().optional(),
+        keywords: z.string().optional(),
+        assignedTo: z.string().optional(),
+        reviewer: z.array(z.string()).optional(),
+        comment: z.string().optional()
+    }).describe(`
 更新用户需求（使用 PUT /stories/:id 接口）
 
 此工具使用标准的"修改需求其他字段"接口(PUT /stories/:id),支持修改多个字段。
 自动处理评审人问题,无需手动设置 needNotReview。
-
-支持对象或JSON字符串格式。
         `.trim())
 }, async ({ requirementId, update }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
-    let updateData;
-    if (typeof update === 'string') {
-        try {
-            updateData = JSON.parse(update);
-        }
-        catch (e) {
-            throw new Error('Invalid JSON string for update parameter');
-        }
-    }
-    else {
-        updateData = update;
-    }
-    const requirement = await zentaoApi.changeStory(requirementId, updateData);
+    const requirement = await zentaoApi.changeStory(requirementId, update);
     return {
         content: [{ type: "text", text: JSON.stringify(requirement, null, 2) }]
     };
@@ -1311,13 +1269,11 @@ server.tool("uploadImageFromClipboard", "上传剪贴板图片到禅道 - 自动
     const path = await import('path');
     const { execSync } = await import('child_process');
     try {
-        console.log('[uploadImageFromClipboard] 开始执行...');
         // 读取系统剪贴板图片
         let fileBuffer;
         let finalFilename;
         // Windows: 使用 PowerShell 脚本读取剪贴板
         if (process.platform === 'win32') {
-            console.log('[uploadImageFromClipboard] Windows平台，使用PowerShell脚本读取剪贴板...');
             // 内嵌 PowerShell 脚本，避免依赖外部文件
             const psScript = `Add-Type -AssemblyName System.Windows.Forms; Add-Type -AssemblyName System.Drawing; $img = [System.Windows.Forms.Clipboard]::GetImage(); if ($img) { $ms = New-Object System.IO.MemoryStream; $img.Save($ms, [System.Drawing.Imaging.ImageFormat]::Png); $bytes = $ms.ToArray(); $ms.Close(); $base64 = [Convert]::ToBase64String($bytes); Write-Output $base64 } else { Write-Output 'NoImage' }`;
             try {
@@ -1329,7 +1285,6 @@ server.tool("uploadImageFromClipboard", "上传剪贴板图片到禅道 - 自动
                     stdio: ['pipe', 'pipe', 'pipe']
                 }).trim();
                 if (!result || result.includes('NoImage') || result.includes('Error')) {
-                    console.error('[uploadImageFromClipboard] 剪贴板中没有图片');
                     return {
                         content: [{
                                 type: "text",
@@ -1343,10 +1298,8 @@ server.tool("uploadImageFromClipboard", "上传剪贴板图片到禅道 - 自动
                 }
                 fileBuffer = Buffer.from(result, 'base64');
                 finalFilename = filename || `clipboard_${Date.now()}.png`;
-                console.log(`[uploadImageFromClipboard] 已读取剪贴板图片，大小: ${fileBuffer.length} bytes`);
             }
             catch (err) {
-                console.error('[uploadImageFromClipboard] Windows读取剪贴板失败:', err);
                 return {
                     content: [{
                             type: "text",
@@ -1362,17 +1315,14 @@ server.tool("uploadImageFromClipboard", "上传剪贴板图片到禅道 - 自动
         }
         // macOS: 使用 pngpaste
         else if (process.platform === 'darwin') {
-            console.log('[uploadImageFromClipboard] macOS平台，使用pngpaste读取剪贴板...');
             const tempFile = path.join(process.cwd(), '.temp_clipboard.png');
             try {
                 execSync(`pngpaste "${tempFile}"`);
                 fileBuffer = fs.readFileSync(tempFile);
                 fs.unlinkSync(tempFile);
                 finalFilename = filename || `clipboard_${Date.now()}.png`;
-                console.log(`[uploadImageFromClipboard] 已读取剪贴板图片，大小: ${fileBuffer.length} bytes`);
             }
             catch (err) {
-                console.error('[uploadImageFromClipboard] macOS读取剪贴板失败:', err);
                 return {
                     content: [{
                             type: "text",
@@ -1387,17 +1337,14 @@ server.tool("uploadImageFromClipboard", "上传剪贴板图片到禅道 - 自动
         }
         // Linux: 使用 xclip
         else {
-            console.log('[uploadImageFromClipboard] Linux平台，使用xclip读取剪贴板...');
             try {
                 const buffer = execSync('xclip -selection clipboard -t image/png -o', {
                     maxBuffer: 10 * 1024 * 1024
                 });
                 fileBuffer = buffer;
                 finalFilename = filename || `clipboard_${Date.now()}.png`;
-                console.log(`[uploadImageFromClipboard] 已读取剪贴板图片，大小: ${fileBuffer.length} bytes`);
             }
             catch (err) {
-                console.error('[uploadImageFromClipboard] Linux读取剪贴板失败:', err);
                 return {
                     content: [{
                             type: "text",
@@ -1413,21 +1360,17 @@ server.tool("uploadImageFromClipboard", "上传剪贴板图片到禅道 - 自动
         // 创建 img 文件夹
         const imgDir = path.join(process.cwd(), 'img');
         if (!fs.existsSync(imgDir)) {
-            console.log(`[uploadImageFromClipboard] 创建目录: ${imgDir}`);
             fs.mkdirSync(imgDir, { recursive: true });
         }
         // 保存到 img 文件夹
         const savedPath = path.join(imgDir, finalFilename);
         fs.writeFileSync(savedPath, fileBuffer);
-        console.log(`[uploadImageFromClipboard] 图片已保存到: ${savedPath}`);
         // 上传到禅道
-        console.log('[uploadImageFromClipboard] 开始上传到禅道...');
         const uploadResult = await zentaoApi.uploadFile({
             file: fileBuffer,
             filename: finalFilename,
             uid
         });
-        console.log('[uploadImageFromClipboard] 上传成功，结果:', uploadResult);
         // 生成禅道需要的 HTML 格式
         const fileId = uploadResult.id;
         const baseUrl = zentaoApi.getConfig().url;
@@ -1445,7 +1388,6 @@ server.tool("uploadImageFromClipboard", "上传剪贴板图片到禅道 - 自动
             message: `图片已保存到本地并上传到禅道`,
             tip: `更新 Bug 描述时，请使用 imageHtml 字段中的 HTML 代码。图片会被包裹在 <p> 标签中以确保正确显示。`
         };
-        console.log('[uploadImageFromClipboard] 返回结果:', response);
         return {
             content: [{
                     type: "text",
@@ -1454,7 +1396,6 @@ server.tool("uploadImageFromClipboard", "上传剪贴板图片到禅道 - 自动
         };
     }
     catch (error) {
-        console.error('[uploadImageFromClipboard] 发生错误:', error);
         const errorResponse = {
             success: false,
             error: error.message || String(error),
@@ -1601,4 +1542,7 @@ server.tool("deleteComment", "删除评论 - 只能删除自己的评论，管
 });
 // Start receiving messages on stdin and sending messages on stdout
 const transport = new StdioServerTransport();
-await server.connect(transport).catch(console.error);
+await server.connect(transport).catch(err => {
+    process.stderr.write('[FATAL] MCP server failed: ' + String(err) + '\n');
+    process.exit(1);
+});

package/dist/mcpHelpers.d.ts

@@ -0,0 +1,13 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ZentaoAPI } from "./api/zentaoApi.js";
+export type ApiGetter = () => ZentaoAPI | null;
+export declare function ensureApi(getApi: ApiGetter): ZentaoAPI;
+export declare function withApi<TArgs, TResult>(getApi: ApiGetter, handler: (api: ZentaoAPI, args: TArgs) => Promise<TResult>): (args: TArgs) => Promise<TResult>;
+export type ToolHandler<TArgs = any> = (args: TArgs) => Promise<any>;
+export interface ToolDefinition<TArgs = any> {
+    name: string;
+    description?: string;
+    schema: any;
+    handler: ToolHandler<TArgs>;
+}
+export declare function registerTools(server: McpServer, tools: ToolDefinition[]): void;

package/dist/mcpHelpers.js

@@ -0,0 +1,24 @@
+export function ensureApi(getApi) {
+    const api = getApi();
+    if (!api) {
+        throw new Error("Please initialize Zentao API first");
+    }
+    return api;
+}
+export function withApi(getApi, handler) {
+    return async (args) => {
+        const api = ensureApi(getApi);
+        return handler(api, args);
+    };
+}
+export function registerTools(server, tools) {
+    for (const tool of tools) {
+        const { name, description, schema, handler } = tool;
+        if (description) {
+            server.tool(name, description, schema, handler);
+        }
+        else {
+            server.tool(name, schema, handler);
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zzp123/mcp-zentao",
-    "version": "1.18.2",
+    "version": "1.18.4",
     "description": "禅道项目管理系统的高级API集成包 - 完整版，包含所有94个工具。另有产品经理、测试工程师、开发工程师专用精简版本可选",
     "main": "dist/index.js",
     "type": "module",