@zzp123/mcp-zentao 1.15.0 → 1.17.0

package/dist/index.js

@@ -29,7 +29,7 @@ if (configIndex !== -1 && configIndex + 1 < args.length) {
 // Create an MCP server
 const server = new McpServer({
     name: "Zentao API",
-    version: "1.0.0"
+    version: "1.16.0"
 });
 // Initialize ZentaoAPI instance
 let zentaoApi = null;
@@ -1504,7 +1504,51 @@ server.tool("downloadFile", {
     fs.writeFileSync(savePath, fileBuffer);
     return { content: [{ type: "text", text: `文件已下载到: ${savePath}` }] };
 });
-// Comment tools (评论工具)
+// Comment tools (评论工具) - 使用 REST API v1
+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("getCommentDetail", "获取单条评论详情", {
+    commentId: z.number().describe("评论ID")
+}, async ({ commentId }) => {
+    if (!zentaoApi)
+        throw new Error("Please initialize Zentao API first");
+    const comment = await zentaoApi.getCommentDetail(commentId);
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify(comment, null, 2)
+            }]
+    };
+});
 server.tool("addComment", "添加评论 - 为需求、任务、Bug等对象添加评论", {
     objectType: z.enum([
         'story', // 软件需求
@@ -1515,42 +1559,87 @@ server.tool("addComment", "添加评论 - 为需求、任务、Bug等对象添
         'testtask', // 测试单
         'todo', // 待办
         'doc', // 文档
+        'execution', // 执行/迭代
+        'project', // 项目
         'doctemplate' // 文档模板
     ]).describe("对象类型"),
     objectID: z.number().describe("对象ID"),
-    comment: z.string().describe("评论内容，支持HTML格式")
-}, async ({ objectType, objectID, comment }) => {
+    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);
+    const result = await zentaoApi.addComment({
+        objectType,
+        objectID,
+        comment,
+        uid
+    });
     return {
         content: [{
                 type: "text",
                 text: JSON.stringify({
-                    status: result.status,
-                    message: result.message,
-                    actionID: result.actionID,
-                    details: `已为 ${objectType} #${objectID} 添加评论`
+                    message: '评论添加成功',
+                    comment: result
                 }, null, 2)
             }]
     };
 });
+server.tool("updateComment", "更新评论 - 只能更新自己的评论", {
+    commentId: z.number().describe("评论ID"),
+    comment: z.string().describe("更新后的评论内容，支持HTML格式"),
+    uid: z.string().optional().describe("唯一标识符（可选）")
+}, async ({ commentId, comment, uid }) => {
+    if (!zentaoApi)
+        throw new Error("Please initialize Zentao API first");
+    const result = await zentaoApi.updateComment(commentId, {
+        comment,
+        uid
+    });
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    message: '评论更新成功',
+                    comment: result
+                }, null, 2)
+            }]
+    };
+});
+server.tool("deleteComment", "删除评论 - 只能删除自己的评论，管理员可以删除所有评论", {
+    commentId: z.number().describe("评论ID")
+}, async ({ commentId }) => {
+    if (!zentaoApi)
+        throw new Error("Please initialize Zentao API first");
+    const result = await zentaoApi.deleteComment(commentId);
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    status: 'success',
+                    message: result.message || '评论删除成功'
+                }, null, 2)
+            }]
+    };
+});
+// 便捷工具 - 为特定类型对象添加评论
 server.tool("addStoryComment", "为需求添加评论 - 专用工具，支持软件需求(story)和用户需求(requirement)", {
     storyId: z.number().describe("需求ID"),
     comment: z.string().describe("评论内容，支持HTML格式")
 }, async ({ storyId, comment }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
-    // 使用 'story' 类型，API会自动识别是 story 还是 requirement
-    const result = await zentaoApi.addComment('story', storyId, comment);
+    const result = await zentaoApi.addComment({
+        objectType: 'story',
+        objectID: storyId,
+        comment
+    });
     return {
         content: [{
                 type: "text",
                 text: JSON.stringify({
-                    status: result.status,
-                    message: result.message,
-                    actionID: result.actionID,
-                    details: `已为需求 #${storyId} 添加评论`
+                    message: `已为需求 #${storyId} 添加评论`,
+                    comment: result
                 }, null, 2)
             }]
     };
@@ -1561,15 +1650,17 @@ server.tool("addTaskComment", "为任务添加评论", {
 }, async ({ taskId, comment }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
-    const result = await zentaoApi.addComment('task', taskId, comment);
+    const result = await zentaoApi.addComment({
+        objectType: 'task',
+        objectID: taskId,
+        comment
+    });
     return {
         content: [{
                 type: "text",
                 text: JSON.stringify({
-                    status: result.status,
-                    message: result.message,
-                    actionID: result.actionID,
-                    details: `已为任务 #${taskId} 添加评论`
+                    message: `已为任务 #${taskId} 添加评论`,
+                    comment: result
                 }, null, 2)
             }]
     };
@@ -1580,15 +1671,17 @@ server.tool("addBugComment", "为Bug添加评论", {
 }, async ({ bugId, comment }) => {
     if (!zentaoApi)
         throw new Error("Please initialize Zentao API first");
-    const result = await zentaoApi.addComment('bug', bugId, comment);
+    const result = await zentaoApi.addComment({
+        objectType: 'bug',
+        objectID: bugId,
+        comment
+    });
     return {
         content: [{
                 type: "text",
                 text: JSON.stringify({
-                    status: result.status,
-                    message: result.message,
-                    actionID: result.actionID,
-                    details: `已为Bug #${bugId} 添加评论`
+                    message: `已为Bug #${bugId} 添加评论`,
+                    comment: result
                 }, null, 2)
             }]
     };

package/dist/roleConfig.d.ts

@@ -0,0 +1,48 @@
+export type Role = 'pm' | 'qa' | 'dev' | 'admin' | 'all';
+export declare const TOOL_CATEGORIES: {
+    init: string[];
+    story: string[];
+    storyReadonly: string[];
+    product: string[];
+    plan: string[];
+    program: string[];
+    feedback: string[];
+    bug: string[];
+    bugResolve: string[];
+    bugReadonly: string[];
+    testcase: string[];
+    task: string[];
+    taskReadonly: string[];
+    project: string[];
+    execution: string[];
+    build: string[];
+    ticket: string[];
+    comment: string[];
+    utility: string[];
+    user: string[];
+};
+export declare const ROLE_PERMISSIONS: Record<Role, string[]>;
+/**
+ * 检查当前角色是否有权限使用指定工具
+ * @param toolName 工具名称
+ * @param role 当前角色
+ * @returns true 如果有权限，false 否则
+ */
+export declare function hasPermission(toolName: string, role?: Role): boolean;
+/**
+ * 获取当前运行环境的角色
+ * @returns 角色类型
+ */
+export declare function getCurrentRole(): Role;
+/**
+ * 获取当前角色的工具列表
+ * @param role 角色类型
+ * @returns 工具名称数组
+ */
+export declare function getToolsForRole(role: Role): string[];
+/**
+ * 获取角色的显示名称
+ * @param role 角色类型
+ * @returns 角色的中文显示名称
+ */
+export declare function getRoleName(role: Role): string;

package/dist/roleConfig.js

@@ -0,0 +1,205 @@
+// 角色配置 - 定义每个角色可以使用的工具
+// 工具分类
+export const TOOL_CATEGORIES = {
+    // 初始化工具（所有角色都需要）
+    init: ['initZentao'],
+    // 需求管理（产品经理完整权限，其他只读）
+    story: [
+        'createStory', 'createRequirement', 'getStoryDetail',
+        'changeStory', 'changeRequirement', 'deleteStory', 'deleteRequirement',
+        'getRequirementDetail', 'getProductStories', 'addStoryComment'
+    ],
+    storyReadonly: ['getStoryDetail', 'getRequirementDetail', 'getProductStories'],
+    // 产品管理（仅产品经理）
+    product: [
+        'getProducts', 'getProductDetail', 'createProduct',
+        'updateProduct', 'deleteProduct'
+    ],
+    // 计划管理（仅产品经理）
+    plan: [
+        'getProductPlans', 'getPlanDetail', 'createPlan',
+        'updatePlan', 'deletePlan', 'linkStoriesToPlan',
+        'unlinkStoriesFromPlan', 'linkBugsToPlan', 'unlinkBugsFromPlan'
+    ],
+    // 项目集管理（仅产品经理）
+    program: [
+        'getPrograms', 'getProgramDetail', 'createProgram',
+        'updateProgram', 'deleteProgram'
+    ],
+    // 反馈管理（仅产品经理）
+    feedback: [
+        'getFeedbacks', 'getFeedbackDetail', 'createFeedback',
+        'updateFeedback', 'deleteFeedback', 'assignFeedback', 'closeFeedback'
+    ],
+    // Bug管理（测试完整权限，开发可以解决，产品只读）
+    bug: [
+        'getMyBugs', 'getProductBugs', 'getBugDetail', 'createBug',
+        'updateBug', 'deleteBug', 'resolveBug', 'addBugComment'
+    ],
+    bugResolve: ['getMyBugs', 'getBugDetail', 'resolveBug', 'addBugComment'],
+    bugReadonly: ['getMyBugs', 'getProductBugs', 'getBugDetail'],
+    // 测试用例（仅测试）
+    testcase: [
+        'getProductTestCases', 'getTestCaseDetail', 'createTestCase',
+        'updateTestCase', 'deleteTestCase'
+    ],
+    // 任务管理（开发完整权限，其他只读）
+    task: [
+        'getMyTasks', 'getTaskDetail', 'createTask',
+        'updateTask', 'finishTask', 'deleteTask', 'addTaskComment'
+    ],
+    taskReadonly: ['getMyTasks', 'getTaskDetail'],
+    // 项目管理（仅开发）
+    project: [
+        'getProjects', 'getProjectDetail', 'createProject',
+        'updateProject', 'deleteProject', 'getProjectReleases',
+        'getProjectExecutions', 'getProjectBuilds'
+    ],
+    // 迭代管理（仅开发）
+    execution: [
+        'getExecutionDetail', 'createExecution', 'updateExecution',
+        'deleteExecution', 'getExecutionBuilds'
+    ],
+    // 版本构建（测试和开发）
+    build: [
+        'getBuildDetail', 'createBuild', 'updateBuild', 'deleteBuild'
+    ],
+    // 工单管理（所有角色）
+    ticket: [
+        'getTickets', 'getTicketDetail', 'createTicket',
+        'updateTicket', 'deleteTicket'
+    ],
+    // 评论功能（所有角色）
+    comment: [
+        'getComments', 'getCommentDetail', 'addComment',
+        'updateComment', 'deleteComment', 'addTaskComment', 'addBugComment'
+    ],
+    // 模块和文件（所有角色）
+    utility: [
+        'getModules', 'uploadFile', 'uploadImageFromClipboard', 'downloadFile'
+    ],
+    // 用户管理（仅管理员）
+    user: [
+        'getUsers', 'getUserDetail', 'getMyProfile', 'createUser',
+        'updateUser', 'deleteUser'
+    ]
+};
+// 角色权限配置
+export const ROLE_PERMISSIONS = {
+    // 产品经理：需求、产品、计划、项目集、反馈、评论
+    pm: [
+        ...TOOL_CATEGORIES.init,
+        ...TOOL_CATEGORIES.story,
+        ...TOOL_CATEGORIES.product,
+        ...TOOL_CATEGORIES.plan,
+        ...TOOL_CATEGORIES.program,
+        ...TOOL_CATEGORIES.feedback,
+        ...TOOL_CATEGORIES.bugReadonly,
+        ...TOOL_CATEGORIES.taskReadonly,
+        ...TOOL_CATEGORIES.comment,
+        ...TOOL_CATEGORIES.ticket,
+        ...TOOL_CATEGORIES.utility
+    ],
+    // 测试工程师：Bug、测试用例、版本构建、评论
+    qa: [
+        ...TOOL_CATEGORIES.init,
+        ...TOOL_CATEGORIES.bug,
+        ...TOOL_CATEGORIES.testcase,
+        ...TOOL_CATEGORIES.build,
+        ...TOOL_CATEGORIES.storyReadonly,
+        ...TOOL_CATEGORIES.taskReadonly,
+        ...TOOL_CATEGORIES.comment,
+        ...TOOL_CATEGORIES.ticket,
+        ...TOOL_CATEGORIES.utility
+    ],
+    // 开发工程师：任务、Bug解决、项目、迭代、版本构建、评论
+    dev: [
+        ...TOOL_CATEGORIES.init,
+        ...TOOL_CATEGORIES.task,
+        ...TOOL_CATEGORIES.bugResolve,
+        ...TOOL_CATEGORIES.project,
+        ...TOOL_CATEGORIES.execution,
+        ...TOOL_CATEGORIES.build,
+        ...TOOL_CATEGORIES.storyReadonly,
+        ...TOOL_CATEGORIES.comment,
+        ...TOOL_CATEGORIES.ticket,
+        ...TOOL_CATEGORIES.utility
+    ],
+    // 管理员：所有工具
+    admin: [
+        ...TOOL_CATEGORIES.init,
+        ...TOOL_CATEGORIES.story,
+        ...TOOL_CATEGORIES.product,
+        ...TOOL_CATEGORIES.plan,
+        ...TOOL_CATEGORIES.program,
+        ...TOOL_CATEGORIES.feedback,
+        ...TOOL_CATEGORIES.bug,
+        ...TOOL_CATEGORIES.testcase,
+        ...TOOL_CATEGORIES.task,
+        ...TOOL_CATEGORIES.project,
+        ...TOOL_CATEGORIES.execution,
+        ...TOOL_CATEGORIES.build,
+        ...TOOL_CATEGORIES.comment,
+        ...TOOL_CATEGORIES.ticket,
+        ...TOOL_CATEGORIES.utility,
+        ...TOOL_CATEGORIES.user
+    ],
+    // 完整权限（默认）
+    all: [] // 空数组表示所有工具都可用
+};
+/**
+ * 检查当前角色是否有权限使用指定工具
+ * @param toolName 工具名称
+ * @param role 当前角色
+ * @returns true 如果有权限，false 否则
+ */
+export function hasPermission(toolName, role = 'all') {
+    // 'all' 角色有所有权限
+    if (role === 'all')
+        return true;
+    // 检查该角色的权限列表
+    const permissions = ROLE_PERMISSIONS[role];
+    if (!permissions)
+        return false;
+    return permissions.includes(toolName);
+}
+/**
+ * 获取当前运行环境的角色
+ * @returns 角色类型
+ */
+export function getCurrentRole() {
+    const role = process.env.ZENTAO_ROLE?.toLowerCase();
+    // 验证是否是有效的角色
+    if (role && ['pm', 'qa', 'dev', 'admin', 'all'].includes(role)) {
+        return role;
+    }
+    // 默认返回 'all'（所有权限）
+    return 'all';
+}
+/**
+ * 获取当前角色的工具列表
+ * @param role 角色类型
+ * @returns 工具名称数组
+ */
+export function getToolsForRole(role) {
+    if (role === 'all') {
+        // 返回所有工具
+        return Object.values(TOOL_CATEGORIES).flat();
+    }
+    return ROLE_PERMISSIONS[role] || [];
+}
+/**
+ * 获取角色的显示名称
+ * @param role 角色类型
+ * @returns 角色的中文显示名称
+ */
+export function getRoleName(role) {
+    const names = {
+        pm: '产品经理',
+        qa: '测试工程师',
+        dev: '开发工程师',
+        admin: '管理员',
+        all: '完整权限'
+    };
+    return names[role] || '未知角色';
+}

package/dist/types/zentao.d.ts

@@ -717,14 +717,31 @@ export interface UploadFileRequest {
     filename: string;
     uid?: string;
 }
-export type CommentObjectType = 'story' | 'requirement' | 'task' | 'bug' | 'testcase' | 'testtask' | 'todo' | 'doc' | 'doctemplate';
+export type CommentObjectType = 'story' | 'requirement' | 'task' | 'bug' | 'testcase' | 'testtask' | 'todo' | 'doc' | 'execution' | 'project' | 'doctemplate';
+export interface Comment {
+    id: number;
+    objectType: string;
+    objectID: number;
+    action: string;
+    actor: string;
+    actorName?: string;
+    date: string;
+    comment: string;
+    extra?: string;
+}
 export interface AddCommentRequest {
     objectType: CommentObjectType;
     objectID: number;
     comment: string;
+    uid?: string;
 }
-export interface CommentResponse {
-    status: string;
-    data?: number;
-    message?: string;
+export interface UpdateCommentRequest {
+    comment: string;
+    uid?: string;
+}
+export interface CommentListResponse {
+    page: number;
+    total: number;
+    limit: number;
+    comments: Comment[];
 }

package/package.json

@@ -1,12 +1,12 @@
 {
     "name": "@zzp123/mcp-zentao",
-    "version": "1.15.0",
-    "description": "禅道项目管理系统的高级API集成包，提供任务管理、Bug跟踪等功能的完整封装，专为Cursor IDE设计的MCP扩展",
+    "version": "1.17.0",
+    "description": "禅道项目管理系统的高级API集成包 - 完整版，包含所有94个工具。另有产品经理、测试工程师、开发工程师专用精简版本可选",
     "main": "dist/index.js",
     "type": "module",
     "types": "dist/index.d.ts",
     "bin": {
-        "zentao": "json-args.js"
+        "mcp-zentao": "dist/index.js"
     },
     "files": [
         "dist",