@zzp123/mcp-zentao 1.1.1 → 1.2.0

package/dist/api/zentaoApi.d.ts

@@ -1,4 +1,4 @@
-import { AssignFeedbackRequest, Bug, BugResolution, BugStatus, Build, CloseFeedbackRequest, CreateBuildRequest, CreateBugRequest, CreateExecutionRequest, CreateFeedbackRequest, CreatePlanRequest, CreateProductRequest, CreateProgramRequest, CreateProjectRequest, CreateStoryRequest, CreateTaskRequest, CreateTestCaseRequest, CreateTicketRequest, CreateUserRequest, Execution, Feedback, Plan, Product, Program, Project, Release, Story, Task, TaskStatus, TaskUpdate, TestCase, Ticket, UpdateBuildRequest, UpdateBugRequest, UpdateExecutionRequest, UpdateFeedbackRequest, UpdatePlanRequest, UpdateProductRequest, UpdateProgramRequest, UpdateProjectRequest, UpdateStoryRequest, UpdateTestCaseRequest, UpdateTicketRequest, UpdateUserRequest, UserDetail, ZentaoConfig } from '../types/zentao';
+import { AssignFeedbackRequest, Bug, BugResolution, BugStatus, Build, CloseFeedbackRequest, CreateBuildRequest, CreateBugRequest, CreateExecutionRequest, CreateFeedbackRequest, CreatePlanRequest, CreateProductRequest, CreateProgramRequest, CreateProjectRequest, CreateStoryRequest, CreateTaskRequest, CreateTestCaseRequest, CreateTicketRequest, CreateUserRequest, Execution, Feedback, FileUploadResponse, Module, ModuleType, Plan, Product, Program, Project, Release, Story, Task, TaskStatus, TaskUpdate, TestCase, Ticket, UpdateBuildRequest, UpdateBugRequest, UpdateExecutionRequest, UpdateFeedbackRequest, UpdatePlanRequest, UpdateProductRequest, UpdateProgramRequest, UpdateProjectRequest, UpdateStoryRequest, UpdateTestCaseRequest, UpdateTicketRequest, UpdateUserRequest, UploadFileRequest, UserDetail, ZentaoConfig } from '../types/zentao';
 export declare class ZentaoAPI {
     private config;
     private client;
@@ -148,4 +148,7 @@ export declare class ZentaoAPI {
     deleteTicket(ticketId: number): Promise<{
         message: string;
     }>;
+    getModules(type: ModuleType, id: number): Promise<Module[]>;
+    uploadFile(uploadRequest: UploadFileRequest): Promise<FileUploadResponse>;
+    downloadFile(fileId: number): Promise<Buffer>;
 }

package/dist/api/zentaoApi.js

@@ -1116,4 +1116,64 @@ export class ZentaoAPI {
             throw error;
         }
     }
+    // 模块相关API
+    async getModules(type, id) {
+        try {
+            console.log(`正在获取模块列表，类型: ${type}, ID: ${id}...`);
+            const params = { type, id };
+            const response = await this.request('GET', '/modules', params);
+            console.log('获取模块列表响应:', response);
+            return response.modules;
+        }
+        catch (error) {
+            console.error('获取模块列表失败:', error);
+            throw error;
+        }
+    }
+    // 文件相关API
+    async uploadFile(uploadRequest) {
+        try {
+            console.log(`正在上传文件: ${uploadRequest.filename}...`);
+            const token = await this.getToken();
+            // 创建FormData
+            const FormData = (await import('form-data')).default;
+            const formData = new FormData();
+            formData.append('imgFile', uploadRequest.file, uploadRequest.filename);
+            const params = uploadRequest.uid ? { uid: uploadRequest.uid } : undefined;
+            const response = await this.client.request({
+                method: 'POST',
+                url: '/files',
+                params,
+                data: formData,
+                headers: {
+                    Token: token,
+                    ...formData.getHeaders()
+                },
+            });
+            console.log('上传文件响应:', response.data);
+            return response.data;
+        }
+        catch (error) {
+            console.error('上传文件失败:', error);
+            throw error;
+        }
+    }
+    async downloadFile(fileId) {
+        try {
+            console.log(`正在下载文件 ${fileId}...`);
+            const token = await this.getToken();
+            const response = await this.client.request({
+                method: 'GET',
+                url: `/files/${fileId}`,
+                headers: { Token: token },
+                responseType: 'arraybuffer'
+            });
+            console.log('下载文件成功');
+            return Buffer.from(response.data);
+        }
+        catch (error) {
+            console.error('下载文件失败:', error);
+            throw error;
+        }
+    }
 }

package/dist/index.js

@@ -380,11 +380,12 @@ server.tool("createBug", {
     task: z.number().optional(),
     story: z.number().optional(),
     deadline: z.string().optional(),
-    openedBuild: z.array(z.string()).optional()
+    openedBuild: z.array(z.string()).optional().default(["trunk"])
 }, async ({ productId, title, severity, pri, type, branch, module, execution, keywords, os, browser, steps, task, story, deadline, openedBuild }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
-    const bug = await zentaoApi.createBug(productId, {
+    // 如果未提供 openedBuild，使用默认值 ["trunk"] 表示主干版本
+    const bugData = {
         title,
         severity,
         pri,
@@ -399,8 +400,9 @@ server.tool("createBug", {
         task,
         story,
         deadline,
-        openedBuild
-    });
+        openedBuild: openedBuild || ["trunk"]
+    };
+    const bug = await zentaoApi.createBug(productId, bugData);
     return {
         content: [{ type: "text", text: JSON.stringify(bug, null, 2) }]
     };
@@ -918,6 +920,45 @@ server.tool("deleteTicket", { ticketId: z.number() }, async ({ ticketId }) => {
         throw new Error("Please initialize Zentao API first");
     return { content: [{ type: "text", text: JSON.stringify(await zentaoApi.deleteTicket(ticketId), null, 2) }] };
 });
+// 模块相关工具
+server.tool("getModules", {
+    type: z.enum(['story', 'task', 'bug', 'case', 'feedback', 'product']),
+    id: z.number()
+}, async ({ type, id }) => {
+    if (!zentaoApi)
+        throw new Error("Please initialize Zentao API first");
+    const modules = await zentaoApi.getModules(type, id);
+    return { content: [{ type: "text", text: JSON.stringify(modules, null, 2) }] };
+});
+// 文件相关工具
+server.tool("uploadFile", {
+    filePath: z.string(),
+    uid: z.string().optional()
+}, async ({ filePath, uid }) => {
+    if (!zentaoApi)
+        throw new Error("Please initialize Zentao API first");
+    const fs = await import('fs');
+    const path = await import('path');
+    const fileBuffer = fs.readFileSync(filePath);
+    const filename = path.basename(filePath);
+    const result = await zentaoApi.uploadFile({
+        file: fileBuffer,
+        filename,
+        uid
+    });
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("downloadFile", {
+    fileId: z.number(),
+    savePath: z.string()
+}, async ({ fileId, savePath }) => {
+    if (!zentaoApi)
+        throw new Error("Please initialize Zentao API first");
+    const fs = await import('fs');
+    const fileBuffer = await zentaoApi.downloadFile(fileId);
+    fs.writeFileSync(savePath, fileBuffer);
+    return { content: [{ type: "text", text: `文件已下载到: ${savePath}` }] };
+});
 // Start receiving messages on stdin and sending messages on stdout
 const transport = new StdioServerTransport();
 await server.connect(transport).catch(console.error);

package/dist/types/zentao.d.ts

@@ -611,3 +611,27 @@ export interface UpdateTicketRequest {
     type?: string;
     desc?: string;
 }
+export interface Module {
+    id: string;
+    root: string;
+    branch: string;
+    name: string;
+    parent: string;
+    path: string;
+    grade: string;
+    order: string;
+    type: string;
+    owner: string;
+    collector?: string;
+    short?: string;
+}
+export type ModuleType = 'story' | 'task' | 'bug' | 'case' | 'feedback' | 'product';
+export interface FileUploadResponse {
+    id: number;
+    url: string;
+}
+export interface UploadFileRequest {
+    file: Buffer | Blob;
+    filename: string;
+    uid?: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zzp123/mcp-zentao",
-    "version": "1.1.1",
+    "version": "1.2.0",
     "description": "禅道项目管理系统的高级API集成包，提供任务管理、Bug跟踪等功能的完整封装，专为Cursor IDE设计的MCP扩展",
     "main": "dist/index.js",
     "type": "module",
@@ -45,11 +45,13 @@
         "@zzp123/mcp-zentao": "^1.1.0",
         "axios": "^1.6.7",
         "chalk": "^4.1.2",
+        "form-data": "^4.0.4",
         "fs": "^0.0.1-security",
         "table": "^6.8.1",
         "yargs": "^17.7.2"
     },
     "devDependencies": {
+        "@types/form-data": "^2.2.1",
         "@types/jest": "^29.5.12",
         "@types/node": "^20.11.19",
         "@types/table": "^6.3.2",