@zzp123/mcp-zentao 1.18.10 → 1.18.12

package/dist/index-pm.js

@@ -270,6 +270,153 @@ server.tool("deleteStory", "删除需求 - 支持软件需求(story)和用户需
         throw new Error("Please initialize Zentao API first");
     return { content: [{ type: "text", text: JSON.stringify(await zentaoApi.deleteStory(storyId), null, 2) }] };
 });
+server.tool("getMyProfile", {}, async () => {
+    if (!zentaoApi)
+        throw new Error("Please initialize Zentao API first");
+    return { content: [{ type: "text", text: JSON.stringify(await zentaoApi.getMyProfile(), null, 2) }] };
+});
+server.tool("getUsers", {
+    page: z.number().optional(),
+    limit: z.number().optional()
+}, async (params) => {
+    if (!zentaoApi)
+        throw new Error("Please initialize Zentao API first");
+    return { content: [{ type: "text", text: JSON.stringify(await zentaoApi.getUsers(params), null, 2) }] };
+});
+server.tool("uploadFile", {
+    filePath: z.string().optional(),
+    base64Data: z.string().optional(),
+    filename: z.string().optional(),
+    uid: z.string().optional()
+}, async ({ filePath, base64Data, filename, uid }) => {
+    if (!zentaoApi)
+        throw new Error("Please initialize Zentao API first");
+    const fs = await import('fs');
+    const path = await import('path');
+    let fileBuffer;
+    let finalFilename;
+    let savedPath;
+    // 如果提供了 base64 数据（复制的图片）
+    if (base64Data) {
+        // 创建 img 文件夹（如果不存在）
+        const imgDir = path.join(process.cwd(), 'img');
+        if (!fs.existsSync(imgDir)) {
+            fs.mkdirSync(imgDir, { recursive: true });
+        }
+        // 处理 base64 数据
+        const matches = base64Data.match(/^data:image\/(\w+);base64,(.+)$/);
+        if (matches) {
+            const ext = matches[1];
+            const data = matches[2];
+            fileBuffer = Buffer.from(data, 'base64');
+            finalFilename = filename || `image_${Date.now()}.${ext}`;
+        }
+        else {
+            // 直接的 base64 数据，没有 data URL 前缀
+            fileBuffer = Buffer.from(base64Data, 'base64');
+            finalFilename = filename || `image_${Date.now()}.png`;
+        }
+        // 保存到 img 文件夹
+        savedPath = path.join(imgDir, finalFilename);
+        fs.writeFileSync(savedPath, fileBuffer);
+    }
+    // 如果提供了文件路径
+    else if (filePath) {
+        fileBuffer = fs.readFileSync(filePath);
+        finalFilename = path.basename(filePath);
+    }
+    else {
+        throw new Error("必须提供 filePath 或 base64Data 参数");
+    }
+    const result = await zentaoApi.uploadFile({
+        file: fileBuffer,
+        filename: finalFilename,
+        uid
+    });
+    // 生成禅道需要的 HTML 格式
+    const fileId = result.id;
+    const baseUrl = zentaoApi.getConfig().url;
+    const imageUrl = `${baseUrl}/zentao/entao/api.php?m=file&f=read&t=png&fileID=${fileId}`;
+    const imageHtml = `<p><img onload="setImageSize(this,0)" src="${imageUrl}" alt="${finalFilename}" /></p>`;
+    const response = {
+        upload: result,
+        fileId: fileId,
+        imageUrl: imageUrl,
+        imageHtml: imageHtml,
+        tip: `更新 Bug 描述时，请使用 imageHtml 字段中的 HTML 代码。图片会被包裹在 <p> 标签中以确保正确显示。`
+    };
+    if (savedPath) {
+        response.savedPath = savedPath;
+    }
+    return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
+});
+server.tool("getComments", "获取评论列表 - 获取指定对象的所有评论", {
+    objectType: z.enum([
+        'story', // 软件需求
+        'requirement', // 用户需求
+        'task', // 任务
+        'bug', // Bug
+        'testcase', // 测试用例
+        'testtask', // 测试单
+        'todo', // 待办
+        'doc', // 文档
+        'execution', // 执行/迭代
+        'project', // 项目
+        'doctemplate' // 文档模板
+    ]).describe("对象类型"),
+    objectID: z.number().describe("对象ID")
+}, async ({ objectType, objectID }) => {
+    if (!zentaoApi)
+        throw new Error("Please initialize Zentao API first");
+    const comments = await zentaoApi.getComments(objectType, objectID);
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    total: comments.length,
+                    objectType,
+                    objectID,
+                    comments
+                }, null, 2)
+            }]
+    };
+});
+server.tool("addComment", "添加评论 - 为需求、任务、Bug等对象添加评论", {
+    objectType: z.enum([
+        'story', // 软件需求
+        'requirement', // 用户需求
+        'task', // 任务
+        'bug', // Bug
+        'testcase', // 测试用例
+        'testtask', // 测试单
+        'todo', // 待办
+        'doc', // 文档
+        'execution', // 执行/迭代
+        'project', // 项目
+        'doctemplate' // 文档模板
+    ]).describe("对象类型"),
+    objectID: z.number().describe("对象ID"),
+    comment: z.string().describe("评论内容，支持HTML格式"),
+    uid: z.string().optional().describe("唯一标识符（可选）")
+}, async ({ objectType, objectID, comment, uid }) => {
+    if (!zentaoApi)
+        throw new Error("Please initialize Zentao API first");
+    const result = await zentaoApi.addComment({
+        objectType,
+        objectID,
+        comment,
+        uid
+    });
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    message: '评论添加成功',
+                    comment: result
+                }, null, 2)
+            }]
+    };
+});
 await startServerTransport(server, { args }).catch(err => {
     process.stderr.write('[FATAL] MCP server failed: ' + String(err) + '\n');
     process.exit(1);

package/dist/roleConfig.js

@@ -82,7 +82,7 @@ export const TOOL_CATEGORIES = {
 };
 // 角色权限配置
 export const ROLE_PERMISSIONS = {
-    // 产品经理：初始化+项目+需求+执行+计划
+    // 产品经理：初始化+项目+需求+执行+计划+评论+用户+文件
     pm: [
         'initZentao',
         'getProjects',
@@ -95,14 +95,26 @@ export const ROLE_PERMISSIONS = {
         'linkStoriesToPlan',
         'createExecution',
         'deleteExecution',
-        'deletePlan'
-    ],
-    // 测试工程师：初始化+缺陷与用例
+        'deletePlan',
+        'getComments',
+        'addComment',
+        'getUsers',
+        'getMyProfile',
+        'uploadFile'
+    ],
+    // 测试工程师：初始化+任务查看+缺陷查看+测试用例完整管理+用户信息+文件
     qa: [
         'initZentao',
-        'createBug',
+        'getTaskDetail',
+        'getBugDetail',
+        'getProductTestCases',
+        'getTestCaseDetail',
         'createTestCase',
-        'getMyBugs'
+        'updateTestCase',
+        'deleteTestCase',
+        'getUsers',
+        'getMyProfile',
+        'uploadFile'
     ],
     // 开发工程师：初始化+缺陷处理
     dev: [

package/package.json

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

package/scripts/generate-role-versions.cjs

@@ -38,7 +38,12 @@ const ROLE_PERMISSIONS = {
         'linkStoriesToPlan', // 产品计划关联需求
         'createExecution', // 创建执行
         'deleteExecution', // 删除执行
-        'deletePlan' // 删除产品计划
+        'deletePlan', // 删除产品计划
+        'getComments', // 查看评论
+        'addComment', // 添加评论
+        'getUsers', // 获取用户列表
+        'getMyProfile', // 获取我的个人信息
+        'uploadFile' // 上传文件
     ],
     qa: [
         ...TOOL_CATEGORIES.init,