@zzp123/mcp-zentao 1.18.2 → 1.18.3

package/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.18.3] - 2025-01-12
+
+### Fixed
+- **修复MCP协议兼容性问题** 🔧
+  - 修复 `changeStory` 和 `changeRequirement` 工具的参数类型错误
+  - 移除 `z.union([z.object({...}), z.string()])` 改为纯对象类型
+  - 解决 "Expected object, received string" 错误
+  - 同时修复完整版和产品经理版本
+
+### Technical
+- 更新 `src/index.ts` 中的 `changeStory` 和 `changeRequirement` 工具定义
+- 更新 `src/index-pm.ts` 中的 `changeStory` 工具定义
+- 符合MCP协议规范，所有参数必须是对象类型
+
 ## [1.17.6] - 2025-11-10
 
 ### Changed

package/dist/index-pm.js

@@ -375,76 +375,58 @@ server.tool("createPlan", {
         content: [{ type: "text", text: JSON.stringify(plan, null, 2) }]
     };
 });
-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) }]
     };

package/dist/index.js

@@ -564,76 +564,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 +860,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) }]
     };

package/package.json

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