@zzp123/mcp-zentao 1.16.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;

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/package.json

@@ -1,12 +1,12 @@
 {
     "name": "@zzp123/mcp-zentao",
-    "version": "1.16.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",

package/scripts/generate-role-versions.cjs

@@ -0,0 +1,214 @@
+const fs = require('fs');
+const path = require('path');
+
+// 角色工具配置
+const TOOL_CATEGORIES = {
+    init: ['initZentao'],
+    story: ['createStory', 'getStoryDetail', 'changeStory', 'deleteStory', 'getProductStories', 'addStoryComment'],
+    storyReadonly: ['getStoryDetail', '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: ['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', 'addStoryComment'],
+    utility: ['getModules', 'uploadFile', 'uploadImageFromClipboard', 'downloadFile'],
+    user: ['getUsers', 'getUserDetail', 'getMyProfile', 'createUser', 'updateUser', 'deleteUser']
+};
+
+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
+    ],
+    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
+    ],
+    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
+    ]
+};
+
+const ROLE_NAMES = {
+    pm: '产品经理',
+    qa: '测试工程师',
+    dev: '开发工程师'
+};
+
+// 读取完整的 index.ts
+const indexPath = path.join(__dirname, 'src', 'index.ts');
+const indexContent = fs.readFileSync(indexPath, 'utf8');
+
+// 提取工具注册块的函数
+function extractToolBlocks(content) {
+    const lines = content.split('\n');
+    const blocks = [];
+    let currentBlock = null;
+    let braceDepth = 0;
+    let parenDepth = 0;
+
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+
+        // 检测 server.tool 的开始
+        if (trimmed.startsWith('server.tool(')) {
+            // 提取工具名
+            const match = trimmed.match(/server\.tool\("([^"]+)"/);
+            if (match) {
+                currentBlock = {
+                    toolName: match[1],
+                    startLine: i,
+                    lines: [line],
+                    braceDepth: 0,
+                    parenDepth: 0
+                };
+
+                // 计算当前行的括号和大括号
+                currentBlock.parenDepth += (line.match(/\(/g) || []).length - (line.match(/\)/g) || []).length;
+                currentBlock.braceDepth += (line.match(/\{/g) || []).length - (line.match(/\}/g) || []).length;
+            }
+        } else if (currentBlock) {
+            // 在工具块内
+            currentBlock.lines.push(line);
+            currentBlock.parenDepth += (line.match(/\(/g) || []).length - (line.match(/\)/g) || []).length;
+            currentBlock.braceDepth += (line.match(/\{/g) || []).length - (line.match(/\}/g) || []).length;
+
+            // 检查是否到达块的结束（圆括号和大括号都平衡，且以 ); 结尾）
+            if (currentBlock.parenDepth === 0 && currentBlock.braceDepth === 0 && trimmed.endsWith(');')) {
+                currentBlock.endLine = i;
+                blocks.push(currentBlock);
+                currentBlock = null;
+            }
+        }
+    }
+
+    return blocks;
+}
+
+// 为每个角色生成文件
+['pm', 'qa', 'dev'].forEach(role => {
+    console.log(`\n正在生成 ${ROLE_NAMES[role]} (${role}) 版本...`);
+
+    const allowedTools = new Set(ROLE_PERMISSIONS[role]);
+    console.log(`  允许的工具: ${Array.from(allowedTools).join(', ')}`);
+
+    // 提取所有工具块
+    const toolBlocks = extractToolBlocks(indexContent);
+    console.log(`  总工具数: ${toolBlocks.length}`);
+
+    // 过滤出允许的工具
+    const allowedBlocks = toolBlocks.filter(block => allowedTools.has(block.toolName));
+    console.log(`  ${ROLE_NAMES[role]}可用工具数: ${allowedBlocks.length}`);
+
+    // 构建新文件内容
+    const lines = indexContent.split('\n');
+    const outputLines = [];
+    const includedLines = new Set();
+
+    // 标记所有要包含的行
+    allowedBlocks.forEach(block => {
+        for (let i = block.startLine; i <= block.endLine; i++) {
+            includedLines.add(i);
+        }
+        // 如果前一行是注释，也包含进来
+        if (block.startLine > 0 && lines[block.startLine - 1].trim().startsWith('//')) {
+            includedLines.add(block.startLine - 1);
+        }
+    });
+
+    // 找到第一个 server.tool 的位置
+    let firstToolLine = toolBlocks.length > 0 ? toolBlocks[0].startLine : lines.length;
+
+    // 输出文件头部（到第一个工具之前）
+    for (let i = 0; i < firstToolLine; i++) {
+        outputLines.push(lines[i]);
+    }
+
+    // 更新服务器名称和版本
+    const headerContent = outputLines.join('\n');
+    let updatedHeader = headerContent
+        .replace(/name: "Zentao API"/, `name: "Zentao API (${ROLE_NAMES[role]})"`)
+        .replace(/version: "1\.16\.0"/, `version: "1.17.0"`);
+
+    // 输出更新后的头部
+    const finalLines = updatedHeader.split('\n');
+
+    // 添加所有允许的工具块
+    let lastEndLine = firstToolLine - 1;
+    allowedBlocks.forEach((block, index) => {
+        // 添加空行分隔（如果需要）
+        if (block.startLine > lastEndLine + 1) {
+            finalLines.push('');
+        }
+
+        // 添加工具块
+        for (let i = block.startLine; i <= block.endLine; i++) {
+            finalLines.push(lines[i]);
+        }
+
+        lastEndLine = block.endLine;
+    });
+
+    // 添加文件尾部（服务器启动代码）
+    const lastToolBlock = toolBlocks[toolBlocks.length - 1];
+    if (lastToolBlock) {
+        for (let i = lastToolBlock.endLine + 1; i < lines.length; i++) {
+            finalLines.push(lines[i]);
+        }
+    }
+
+    // 写入文件
+    const output = finalLines.join('\n');
+    const outputPath = path.join(__dirname, 'src', `index-${role}.ts`);
+    fs.writeFileSync(outputPath, output, 'utf8');
+
+    console.log(`  ✓ 已生成: ${outputPath}`);
+
+    // 统计文件大小
+    const stats = fs.statSync(outputPath);
+    const originalStats = fs.statSync(indexPath);
+    const reduction = ((1 - stats.size / originalStats.size) * 100).toFixed(1);
+    console.log(`  文件大小: ${(stats.size / 1024).toFixed(1)} KB (原始: ${(originalStats.size / 1024).toFixed(1)} KB, 减少 ${reduction}%)`);
+});
+
+console.log('\n✓ 所有角色版本生成完成！');
+console.log('\n下一步：');
+console.log('1. 运行 npx tsc 编译所有版本');
+console.log('2. 配置 package.json 的构建脚本');
+console.log('3. 测试各个版本');