@zzp123/mcp-zentao 1.7.3 → 1.8.0

package/CHANGELOG.md

@@ -5,6 +5,43 @@ 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.8.0] - 2025-11-06
+
+### Changed
+- **重构需求变更接口命名**
+  - 将 `updateStory` 工具重命名为 `changeStory`，更准确地反映其功能
+  - 将 `UpdateStoryRequest` 类型重命名为 `ChangeStoryRequest`
+  - 将 `updateStory` API方法重命名为 `changeStory`
+  - 使用功能完整的"修改需求其他字段"接口替代功能有限的"变更需求"接口
+
+### Added
+- 向后兼容的类型别名：`UpdateStoryRequest` 作为 `ChangeStoryRequest` 的别名
+
+### Technical
+- 统一需求变更相关的命名规范
+- 保持向后兼容性，旧的类型名称仍然可用
+- 所有测试通过，确保重构不影响现有功能
+
+## [1.7.4] - 2025-11-06
+
+### Fixed
+- **修复 createTask 和 updateStory 中的评审人相关错误**
+  - 修复 `createTask` 工具中 `assignedTo` 参数类型错误（从字符串改为数组）
+  - 修复 `createTask` 工具中必填参数缺失问题（execution, type, estStarted, deadline）
+  - 修复 `updateStory` 工具中"评审人不能为null"错误
+  - 为 `updateStory` 添加自动跳过评审机制（needNotReview=true）
+
+### Changed
+- `CreateTaskRequest` 接口更新：将 assignedTo 从可选字符串改为必需数组
+- `createTask` MCP 工具参数重新定义：必填参数前置，类型修正
+- `updateStory` API 方法添加智能评审人处理逻辑
+- API 请求表单数据处理：支持数组类型参数的正确格式化
+
+### Technical
+- 更新测试文件以适配新的接口要求
+- TypeScript 编译验证通过，确保类型安全
+- 保持向后兼容性，同时修复API规范问题
+
 ## [1.7.3] - 2025-11-06
 
 ### Fixed

package/dist/api/zentaoApi.d.ts

@@ -1,4 +1,4 @@
-import { AssignFeedbackRequest, Bug, BugStatus, Build, CloseFeedbackRequest, CreateBuildRequest, CreateBugRequest, CreateExecutionRequest, CreateFeedbackRequest, CreatePlanRequest, CreateProductRequest, CreateProgramRequest, CreateProjectRequest, CreateStoryRequest, CreateTaskRequest, CreateTestCaseRequest, CreateTicketRequest, CreateUserRequest, Execution, Feedback, FileUploadResponse, ModulesResponse, ModuleType, Plan, Product, Program, Project, Release, ResolveBugRequest, Story, Task, TaskStatus, TaskUpdate, TestCase, Ticket, UpdateBuildRequest, UpdateBugRequest, UpdateExecutionRequest, UpdateFeedbackRequest, UpdatePlanRequest, UpdateProductRequest, UpdateProgramRequest, UpdateProjectRequest, UpdateStoryRequest, UpdateTestCaseRequest, UpdateTicketRequest, UpdateUserRequest, UploadFileRequest, UserDetail, ZentaoConfig } from '../types/zentao';
+import { AssignFeedbackRequest, Bug, BugStatus, Build, CloseFeedbackRequest, CreateBuildRequest, CreateBugRequest, CreateExecutionRequest, CreateFeedbackRequest, CreatePlanRequest, CreateProductRequest, CreateProgramRequest, CreateProjectRequest, CreateStoryRequest, CreateTaskRequest, CreateTestCaseRequest, CreateTicketRequest, CreateUserRequest, Execution, Feedback, FileUploadResponse, ModulesResponse, ModuleType, Plan, Product, Program, Project, Release, ResolveBugRequest, Story, Task, TaskStatus, TaskUpdate, TestCase, Ticket, UpdateBuildRequest, UpdateBugRequest, UpdateExecutionRequest, UpdateFeedbackRequest, UpdatePlanRequest, UpdateProductRequest, UpdateProgramRequest, UpdateProjectRequest, ChangeStoryRequest, UpdateTestCaseRequest, UpdateTicketRequest, UpdateUserRequest, UploadFileRequest, UserDetail, ZentaoConfig } from '../types/zentao';
 export declare class ZentaoAPI {
     private config;
     private client;
@@ -33,7 +33,7 @@ export declare class ZentaoAPI {
     getProjectExecutions(projectId: number): Promise<Execution[]>;
     createPlan(productId: number, plan: CreatePlanRequest): Promise<Plan>;
     getProjects(page?: number, limit?: number): Promise<Project[]>;
-    updateStory(storyId: number, update: UpdateStoryRequest): Promise<Story>;
+    changeStory(storyId: number, update: ChangeStoryRequest): Promise<Story>;
     deleteTask(taskId: number): Promise<{
         message: string;
     }>;

package/dist/api/zentaoApi.js

@@ -217,7 +217,15 @@ export class ZentaoAPI {
             const formData = new URLSearchParams();
             Object.entries(task).forEach(([key, value]) => {
                 if (value !== undefined && value !== null) {
-                    formData.append(key, value.toString());
+                    if (key === 'assignedTo' && Array.isArray(value)) {
+                        // 对于assignedTo数组，需要特殊处理
+                        value.forEach((item, index) => {
+                            formData.append(`${key}[${index}]`, item.toString());
+                        });
+                    }
+                    else {
+                        formData.append(key, value.toString());
+                    }
                 }
             });
             // 在URL中添加执行ID
@@ -487,15 +495,22 @@ export class ZentaoAPI {
             throw error;
         }
     }
-    async updateStory(storyId, update) {
+    async changeStory(storyId, update) {
         try {
-            console.log(`正在更新需求 ${storyId}...`);
-            const response = await this.request('PUT', `/stories/${storyId}`, undefined, update);
-            console.log('更新需求响应:', response);
+            console.log(`正在变更需求 ${storyId}...`);
+            // 自动处理评审人问题
+            const updateData = { ...update };
+            // 如果用户没有设置评审人，也没有指定无需评审，则自动跳过评审
+            if (!updateData.reviewer && updateData.needNotReview !== true) {
+                updateData.needNotReview = true;
+                console.log('自动设置needNotReview=true以跳过评审要求');
+            }
+            const response = await this.request('PUT', `/stories/${storyId}`, undefined, updateData);
+            console.log('变更需求响应:', response);
             return response;
         }
         catch (error) {
-            console.error('更新需求失败:', error);
+            console.error('变更需求失败:', error);
             throw error;
         }
     }

package/dist/index.js

@@ -197,32 +197,32 @@ server.tool("getProductPlans", {
 server.tool("createTask", {
     name: z.string(),
     execution: z.number(),
+    type: z.string(),
+    assignedTo: z.array(z.string()),
+    estStarted: z.string(),
+    deadline: z.string(),
     desc: z.string().optional(),
     pri: z.number().min(1).max(4).optional(),
     estimate: z.number().optional(),
     project: z.number().optional(),
     module: z.number().optional(),
-    story: z.number().optional(),
-    type: z.string().optional(),
-    assignedTo: z.string().optional(),
-    estStarted: z.string().optional(),
-    deadline: z.string().optional()
+    story: z.number().optional()
 }, async ({ name, execution, desc, pri, estimate, project, module, story, type, assignedTo, estStarted, deadline }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
     const task = await zentaoApi.createTask({
         name,
         execution,
+        type,
+        assignedTo,
+        estStarted,
+        deadline,
         desc,
         pri,
         estimate,
         project,
         module,
-        story,
-        type,
-        assignedTo,
-        estStarted,
-        deadline
+        story
     });
     return {
         content: [{ type: "text", text: JSON.stringify(task, null, 2) }]
@@ -460,8 +460,8 @@ server.tool("getProjects", {
         content: [{ type: "text", text: JSON.stringify(projects, null, 2) }]
     };
 });
-// Add updateStory tool
-server.tool("updateStory", {
+// Add changeStory tool
+server.tool("changeStory", {
     storyId: z.number(),
     update: z.union([
         z.object({
@@ -507,7 +507,7 @@ server.tool("updateStory", {
             comment: z.string().optional()
         }),
         z.string()
-    ]).describe("需求更新字段 - 支持对象或JSON字符串格式")
+    ]).describe("需求变更字段 - 支持对象或JSON字符串格式")
 }, async ({ storyId, update }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
@@ -524,7 +524,7 @@ server.tool("updateStory", {
     else {
         updateData = update;
     }
-    const story = await zentaoApi.updateStory(storyId, updateData);
+    const story = await zentaoApi.changeStory(storyId, updateData);
     return {
         content: [{ type: "text", text: JSON.stringify(story, null, 2) }]
     };

package/dist/types/zentao.d.ts

@@ -10,13 +10,13 @@ export interface CreateTaskRequest {
     pri?: number;
     estimate?: number;
     project?: number;
-    execution?: number;
+    execution: number;
     module?: number;
     story?: number;
-    type?: string;
-    assignedTo?: string;
-    estStarted?: string;
-    deadline?: string;
+    type: string;
+    assignedTo: string[];
+    estStarted: string;
+    deadline: string;
 }
 export interface Task {
     id: number;
@@ -256,7 +256,7 @@ export interface Project {
     PM: string | User;
     progress: number;
 }
-export interface UpdateStoryRequest {
+export interface ChangeStoryRequest {
     title?: string;
     product?: number;
     parent?: number;
@@ -287,6 +287,7 @@ export interface UpdateStoryRequest {
     verify?: string;
     comment?: string;
 }
+export type UpdateStoryRequest = ChangeStoryRequest;
 export interface CreateProgramRequest {
     name?: string;
     parent?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zzp123/mcp-zentao",
-    "version": "1.7.3",
+    "version": "1.8.0",
     "description": "禅道项目管理系统的高级API集成包，提供任务管理、Bug跟踪等功能的完整封装，专为Cursor IDE设计的MCP扩展",
     "main": "dist/index.js",
     "type": "module",