@zzp123/mcp-zentao 1.18.1 → 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/api/zentaoApi.d.ts

@@ -33,17 +33,16 @@ export declare class ZentaoAPI {
      */
     private filterBugFields;
     /**
-     * 获取我的 Bug 列表（固定查询指派给我的 Bug）
+     * 获取我的 Bug 列表（固定查询指派给我的 Bug，固定每页20条）
      *
      * @param productId 产品ID（可选，默认使用第二个产品）
      * @param page 页码（从1开始，默认1）
-     * @param limit 每页数量（默认20，最大100）
      * @param branch 分支筛选（'all'所有分支/'0'主干/分支ID，默认'all'）
      * @param order 排序字段（如：'id_desc'、'pri_desc'等，默认'id_desc'）
      * @param fields 返回字段级别（'basic'基本/'default'默认/'full'完整，默认'basic'）
      * @returns Promise<Bug列表及分页信息>
      */
-    getMyBugs(productId?: number, page?: number, limit?: number, branch?: string, order?: string, fields?: 'basic' | 'default' | 'full'): Promise<{
+    getMyBugs(productId?: number, page?: number, branch?: string, order?: string, fields?: 'basic' | 'default' | 'full'): Promise<{
         page: number;
         total: number;
         limit: number;

package/dist/api/zentaoApi.js

@@ -235,17 +235,16 @@ export class ZentaoAPI {
         };
     }
     /**
-     * 获取我的 Bug 列表（固定查询指派给我的 Bug）
+     * 获取我的 Bug 列表（固定查询指派给我的 Bug，固定每页20条）
      *
      * @param productId 产品ID（可选，默认使用第二个产品）
      * @param page 页码（从1开始，默认1）
-     * @param limit 每页数量（默认20，最大100）
      * @param branch 分支筛选（'all'所有分支/'0'主干/分支ID，默认'all'）
      * @param order 排序字段（如：'id_desc'、'pri_desc'等，默认'id_desc'）
      * @param fields 返回字段级别（'basic'基本/'default'默认/'full'完整，默认'basic'）
      * @returns Promise<Bug列表及分页信息>
      */
-    async getMyBugs(productId, page, limit, branch, order, fields) {
+    async getMyBugs(productId, page, branch, order, fields) {
         if (!productId) {
             // 如果没有提供产品ID，获取第二个可用的产品（索引为1）
             const products = await this.getProducts();
@@ -256,8 +255,8 @@ export class ZentaoAPI {
             productId = products.length > 1 ? products[1].id : products[0].id;
             console.log(`使用产品ID: ${productId} (${products.length > 1 ? '第二个' : '第一个'})`);
         }
-        // 默认每页20条，最多100条
-        const finalLimit = limit ? Math.min(limit, 100) : 20;
+        // 固定每页20条
+        const finalLimit = 20;
         const finalPage = page || 1;
         const finalBranch = branch || 'all';
         const finalOrder = order || 'id_desc';

package/dist/index-dev.js

@@ -75,17 +75,16 @@ server.tool("getTaskDetail", {
         content: [{ type: "text", text: JSON.stringify(task, null, 2) }]
     };
 });
-server.tool("getMyBugs", "获取我的Bug列表 - 固定查询指派给我的Bug（status='assigntome'）", {
+server.tool("getMyBugs", "获取我的Bug列表 - 固定查询指派给我的Bug（status='assigntome'），固定每页20条", {
     productId: z.number().optional().describe("产品ID，默认使用第二个产品"),
     page: z.number().optional().describe("页码，从1开始，默认为1"),
-    limit: z.number().optional().describe("每页数量，默认20，最大100"),
     branch: z.string().optional().describe("分支筛选：'all'(所有分支,默认)、'0'(主干分支)、分支ID"),
     order: z.string().optional().describe("排序方式，如 id_desc(ID降序), pri_desc(优先级降序), openedDate_desc(创建时间降序)等，默认id_desc"),
     fields: z.enum(['basic', 'default', 'full']).optional().describe("返回字段级别：'basic'(基本字段,默认)、'default'(默认字段)、'full'(完整字段)，默认'basic'")
-}, async ({ productId, page, limit, branch, order, fields }) => {
+}, async ({ productId, page, branch, order, fields }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
-    const result = await zentaoApi.getMyBugs(productId, page, limit, branch, order, fields);
+    const result = await zentaoApi.getMyBugs(productId, page, branch, order, fields);
     // 返回分页信息和数据
     const summary = {
         summary: `当前第 ${result.page} 页，共 ${result.total} 个Bug，本页显示 ${result.bugs.length} 个`,

package/dist/index-pm.js

@@ -85,17 +85,16 @@ server.tool("getProducts", "获取产品列表 - 只返回核心字段（id, 名
         content: [{ type: "text", text: JSON.stringify(products, null, 2) }]
     };
 });
-server.tool("getMyBugs", "获取我的Bug列表 - 固定查询指派给我的Bug（status='assigntome'）", {
+server.tool("getMyBugs", "获取我的Bug列表 - 固定查询指派给我的Bug（status='assigntome'），固定每页20条", {
     productId: z.number().optional().describe("产品ID，默认使用第二个产品"),
     page: z.number().optional().describe("页码，从1开始，默认为1"),
-    limit: z.number().optional().describe("每页数量，默认20，最大100"),
     branch: z.string().optional().describe("分支筛选：'all'(所有分支,默认)、'0'(主干分支)、分支ID"),
     order: z.string().optional().describe("排序方式，如 id_desc(ID降序), pri_desc(优先级降序), openedDate_desc(创建时间降序)等，默认id_desc"),
     fields: z.enum(['basic', 'default', 'full']).optional().describe("返回字段级别：'basic'(基本字段,默认)、'default'(默认字段)、'full'(完整字段)，默认'basic'")
-}, async ({ productId, page, limit, branch, order, fields }) => {
+}, async ({ productId, page, branch, order, fields }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
-    const result = await zentaoApi.getMyBugs(productId, page, limit, branch, order, fields);
+    const result = await zentaoApi.getMyBugs(productId, page, branch, order, fields);
     // 返回分页信息和数据
     const summary = {
         summary: `当前第 ${result.page} 页，共 ${result.total} 个Bug，本页显示 ${result.bugs.length} 个`,
@@ -376,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-qa.js

@@ -75,17 +75,16 @@ server.tool("getTaskDetail", {
         content: [{ type: "text", text: JSON.stringify(task, null, 2) }]
     };
 });
-server.tool("getMyBugs", "获取我的Bug列表 - 固定查询指派给我的Bug（status='assigntome'）", {
+server.tool("getMyBugs", "获取我的Bug列表 - 固定查询指派给我的Bug（status='assigntome'），固定每页20条", {
     productId: z.number().optional().describe("产品ID，默认使用第二个产品"),
     page: z.number().optional().describe("页码，从1开始，默认为1"),
-    limit: z.number().optional().describe("每页数量，默认20，最大100"),
     branch: z.string().optional().describe("分支筛选：'all'(所有分支,默认)、'0'(主干分支)、分支ID"),
     order: z.string().optional().describe("排序方式，如 id_desc(ID降序), pri_desc(优先级降序), openedDate_desc(创建时间降序)等，默认id_desc"),
     fields: z.enum(['basic', 'default', 'full']).optional().describe("返回字段级别：'basic'(基本字段,默认)、'default'(默认字段)、'full'(完整字段)，默认'basic'")
-}, async ({ productId, page, limit, branch, order, fields }) => {
+}, async ({ productId, page, branch, order, fields }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
-    const result = await zentaoApi.getMyBugs(productId, page, limit, branch, order, fields);
+    const result = await zentaoApi.getMyBugs(productId, page, branch, order, fields);
     // 返回分页信息和数据
     const summary = {
         summary: `当前第 ${result.page} 页，共 ${result.total} 个Bug，本页显示 ${result.bugs.length} 个`,

package/dist/index.js

@@ -89,17 +89,16 @@ server.tool("getProducts", "获取产品列表 - 只返回核心字段（id, 名
     };
 });
 // Add getMyBugs tool
-server.tool("getMyBugs", "获取我的Bug列表 - 固定查询指派给我的Bug（status='assigntome'）", {
+server.tool("getMyBugs", "获取我的Bug列表 - 固定查询指派给我的Bug（status='assigntome'），固定每页20条", {
     productId: z.number().optional().describe("产品ID，默认使用第二个产品"),
     page: z.number().optional().describe("页码，从1开始，默认为1"),
-    limit: z.number().optional().describe("每页数量，默认20，最大100"),
     branch: z.string().optional().describe("分支筛选：'all'(所有分支,默认)、'0'(主干分支)、分支ID"),
     order: z.string().optional().describe("排序方式，如 id_desc(ID降序), pri_desc(优先级降序), openedDate_desc(创建时间降序)等，默认id_desc"),
     fields: z.enum(['basic', 'default', 'full']).optional().describe("返回字段级别：'basic'(基本字段,默认)、'default'(默认字段)、'full'(完整字段)，默认'basic'")
-}, async ({ productId, page, limit, branch, order, fields }) => {
+}, async ({ productId, page, branch, order, fields }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
-    const result = await zentaoApi.getMyBugs(productId, page, limit, branch, order, fields);
+    const result = await zentaoApi.getMyBugs(productId, page, branch, order, fields);
     // 返回分页信息和数据
     const summary = {
         summary: `当前第 ${result.page} 页，共 ${result.total} 个Bug，本页显示 ${result.bugs.length} 个`,
@@ -565,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) }]
     };
@@ -879,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.1",
+    "version": "1.18.3",
     "description": "禅道项目管理系统的高级API集成包 - 完整版，包含所有94个工具。另有产品经理、测试工程师、开发工程师专用精简版本可选",
     "main": "dist/index.js",
     "type": "module",