mcp-probe-kit 1.2.7 → 1.2.9

package/build/index.js

@@ -3,10 +3,11 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { detectShell, initSetting, initProject, gencommit, debug, genapi, codeReview, gentest, genpr, checkDeps, gendoc, genchangelog, refactor, perf, fix, gensql, resolveConflict, genui, explain, convert, genreadme, split, analyzeProject } from "./tools/index.js";
+import { VERSION, NAME } from "./version.js";
 // 创建MCP服务器实例
 const server = new Server({
-    name: "mcp-probe-kit",
-    version: "1.2.7",
+    name: NAME,
+    version: VERSION,
 }, {
     capabilities: {
         tools: {},
@@ -527,8 +528,8 @@ server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
                         status: "running",
                         timestamp: new Date().toISOString(),
                         serverInfo: {
-                            name: "mcp-probe-kit",
-                            version: "1.2.7",
+                            name: NAME,
+                            version: VERSION,
                             description: "Cursor 开发增强工具集",
                         },
                         tools: {

package/build/tools/analyze_project.js

@@ -1,67 +1,80 @@
 import { readFileSync, readdirSync, statSync, existsSync } from 'fs';
 import { join, extname } from 'path';
+import { VERSION } from '../version.js';
 export async function analyzeProject(args) {
     const projectPath = args.project_path || process.cwd();
     const maxDepth = args.max_depth || 5;
     const includeContent = args.include_content !== false;
     try {
+        console.error(`开始分析项目: ${projectPath}`);
         const analysis = await performProjectAnalysis(projectPath, maxDepth, includeContent);
         return {
             content: [
                 {
                     type: "text",
-                    text: `# 📊 项目分析报告
-
-## 🏗️ 项目概览
-- **项目名称**: ${analysis.projectStructure.name}
-- **项目类型**: ${analysis.projectStructure.type}
-- **技术栈**: ${analysis.projectStructure.framework}
-- **主要语言**: ${analysis.projectStructure.language}
-- **包管理器**: ${analysis.projectStructure.packageManager}
-
-## 📁 目录结构
-\`\`\`
-${analysis.directoryTree}
-\`\`\`
-
-## 🔑 关键文件
-${analysis.keyFiles.map(file => `### ${file.path}
-**用途**: ${file.purpose}
-${includeContent ? `\`\`\`${getFileExtension(file.path)}
-${file.content.substring(0, 500)}${file.content.length > 500 ? '\n...' : ''}
-\`\`\`` : ''}`).join('\n\n')}
-
-## 📦 依赖分析
-- **生产依赖**: ${analysis.dependencies.production.length} 个
-- **开发依赖**: ${analysis.dependencies.development.length} 个
-- **总依赖数**: ${analysis.dependencies.total} 个
-
-### 主要依赖
-${analysis.dependencies.production.slice(0, 10).map(dep => `- ${dep}`).join('\n')}
-
-## 📈 代码指标
-- **总文件数**: ${analysis.codeMetrics.totalFiles}
-- **总行数**: ${analysis.codeMetrics.totalLines}
-- **文件类型分布**:
-${Object.entries(analysis.codeMetrics.fileTypes).map(([type, count]) => `  - ${type}: ${count} 个文件`).join('\n')}
-
-### 最大文件
-${analysis.codeMetrics.largestFiles.slice(0, 5).map(file => `- ${file.path} (${file.lines} 行)`).join('\n')}
-
-## 🏛️ 架构分析
-- **设计模式**: ${analysis.architecture.patterns.join(', ')}
-- **入口文件**: ${analysis.architecture.entryPoints.join(', ')}
-- **核心模块**: ${analysis.architecture.mainModules.join(', ')}
-
-## 📋 项目总结
-**项目目的**: ${analysis.summary.purpose}
-**复杂度**: ${analysis.summary.complexity}
-**建议**: 
-${analysis.summary.recommendations.map(rec => `- ${rec}`).join('\n')}
-
----
-*分析完成时间: ${new Date().toLocaleString('zh-CN')}*
-*分析工具: MCP Probe Kit v1.2.0*`,
+                    text: `# 📊 项目分析报告
+
+## 🏗️ 项目概览
+- **项目名称**: ${analysis.projectStructure.name}
+- **项目类型**: ${analysis.projectStructure.type}
+- **技术栈**: ${analysis.projectStructure.framework}
+- **主要语言**: ${analysis.projectStructure.language}
+- **包管理器**: ${analysis.projectStructure.packageManager}
+
+## 📁 目录结构
+\`\`\`
+${analysis.directoryTree}
+\`\`\`
+
+## 🔑 关键文件
+${analysis.keyFiles.map(file => `### ${file.path}
+**用途**: ${file.purpose}
+${includeContent ? `\`\`\`${getFileExtension(file.path)}
+${file.content.substring(0, 500)}${file.content.length > 500 ? '\n...' : ''}
+\`\`\`` : ''}`).join('\n\n')}
+
+## 📦 依赖分析
+- **生产依赖**: ${analysis.dependencies.production.length} 个
+- **开发依赖**: ${analysis.dependencies.development.length} 个
+- **总依赖数**: ${analysis.dependencies.total} 个
+
+### 主要依赖
+${analysis.dependencies.production.slice(0, 10).map(dep => `- ${dep}`).join('\n')}
+
+## 📈 代码指标
+- **总文件数**: ${analysis.codeMetrics.totalFiles}
+- **总行数**: ${analysis.codeMetrics.totalLines}
+${analysis.codeMetrics.skippedFiles > 0 ? `- **跳过文件**: ${analysis.codeMetrics.skippedFiles} 个（过大或无法读取）` : ''}
+- **文件类型分布**:
+${Object.entries(analysis.codeMetrics.fileTypes)
+                        .sort(([, a], [, b]) => b - a)
+                        .slice(0, 10)
+                        .map(([type, count]) => `  - ${type}: ${count} 个文件`)
+                        .join('\n')}
+${Object.keys(analysis.codeMetrics.fileTypes).length > 10 ? '  - ... (更多类型已省略)' : ''}
+
+### 最大文件
+${analysis.codeMetrics.largestFiles.slice(0, 5).map(file => `- ${file.path} (${file.lines} 行)`).join('\n')}
+
+## 🏛️ 架构分析
+- **设计模式**: ${analysis.architecture.patterns.join(', ')}
+- **入口文件**: ${analysis.architecture.entryPoints.join(', ')}
+- **核心模块**: ${analysis.architecture.mainModules.join(', ')}
+
+## 📋 项目总结
+**项目目的**: ${analysis.summary.purpose}
+**复杂度**: ${analysis.summary.complexity}
+**建议**: 
+${analysis.summary.recommendations.map(rec => `- ${rec}`).join('\n')}
+
+---
+*分析完成时间: ${new Date().toLocaleString('zh-CN')}*
+*分析工具: MCP Probe Kit v${VERSION}*
+
+**分析说明**:
+- 大型项目会自动采样分析，限制最多扫描 5000 个文件
+- 已自动忽略以下目录: \`node_modules\`, \`dist\`, \`build\`, \`.git\`, \`coverage\`, \`.next\`, \`.nuxt\`, \`vendor\` 等
+- 单个文件大小限制: 1MB，超过则跳过`,
                 },
             ],
         };
@@ -181,19 +194,34 @@ function detectPackageManager() {
     return 'npm';
 }
 function generateDirectoryTree(projectPath, maxDepth) {
-    const ignoreDirs = ['node_modules', '.git', 'dist', 'build', '.next', '.nuxt'];
+    const ignoreDirs = [
+        'node_modules', '.git', 'dist', 'build', '.next', '.nuxt',
+        'coverage', '.vscode', '.idea', 'tmp', 'temp', 'out',
+        'vendor', '__pycache__', '.cache', '.parcel-cache',
+        'bower_components', 'jspm_packages'
+    ];
+    const MAX_ITEMS_PER_DIR = 50; // 每个目录最多显示50项
     function buildTree(dir, prefix = '', depth = 0) {
         if (depth >= maxDepth)
             return '';
         try {
-            const items = readdirSync(dir)
+            let items = readdirSync(dir)
                 .filter(item => !ignoreDirs.includes(item) && !item.startsWith('.'))
                 .map(item => {
                 const fullPath = join(dir, item);
-                const stat = statSync(fullPath);
-                return { name: item, isDir: stat.isDirectory(), path: fullPath };
+                try {
+                    const stat = statSync(fullPath);
+                    return { name: item, isDir: stat.isDirectory(), path: fullPath };
+                }
+                catch {
+                    return null;
+                }
             })
-                .sort((a, b) => {
+                .filter(item => item !== null);
+            // 限制每个目录显示的项目数量
+            const hasMore = items.length > MAX_ITEMS_PER_DIR;
+            items = items.slice(0, MAX_ITEMS_PER_DIR);
+            items.sort((a, b) => {
                 if (a.isDir && !b.isDir)
                     return -1;
                 if (!a.isDir && b.isDir)
@@ -202,7 +230,7 @@ function generateDirectoryTree(projectPath, maxDepth) {
             });
             let result = '';
             items.forEach((item, index) => {
-                const isLast = index === items.length - 1;
+                const isLast = index === items.length - 1 && !hasMore;
                 const currentPrefix = isLast ? '└── ' : '├── ';
                 const nextPrefix = isLast ? '    ' : '│   ';
                 result += `${prefix}${currentPrefix}${item.name}\n`;
@@ -210,6 +238,9 @@ function generateDirectoryTree(projectPath, maxDepth) {
                     result += buildTree(item.path, prefix + nextPrefix, depth + 1);
                 }
             });
+            if (hasMore) {
+                result += `${prefix}└── ... (更多项目被省略)\n`;
+            }
             return result;
         }
         catch {
@@ -225,12 +256,31 @@ async function identifyKeyFiles(projectPath, includeContent) {
         'webpack.config.js', 'vite.config.js', 'next.config.js', 'nuxt.config.js',
         'tsconfig.json', 'babel.config.js', '.env', '.env.example'
     ];
+    const MAX_FILE_SIZE = 100 * 1024; // 100KB
+    const MAX_CONTENT_LINES = 100; // 最多显示100行
     const keyFiles = [];
     for (const pattern of keyFilePatterns) {
         try {
             const filePath = join(projectPath, pattern);
-            const content = readFileSync(filePath, 'utf-8');
+            const stat = statSync(filePath);
+            // 跳过过大的文件
+            if (stat.size > MAX_FILE_SIZE) {
+                keyFiles.push({
+                    path: pattern,
+                    purpose: getFilePurpose(pattern, ''),
+                    content: includeContent ? `[文件过大 (${Math.round(stat.size / 1024)}KB)，已跳过]` : ''
+                });
+                continue;
+            }
+            let content = readFileSync(filePath, 'utf-8');
             const purpose = getFilePurpose(pattern, content);
+            // 限制内容行数
+            if (includeContent && content) {
+                const lines = content.split('\n');
+                if (lines.length > MAX_CONTENT_LINES) {
+                    content = lines.slice(0, MAX_CONTENT_LINES).join('\n') + `\n... (省略 ${lines.length - MAX_CONTENT_LINES} 行)`;
+                }
+            }
             keyFiles.push({
                 path: pattern,
                 purpose,
@@ -280,16 +330,39 @@ function analyzeDependencies(packageJson) {
 async function calculateCodeMetrics(projectPath) {
     const fileTypes = {};
     const largestFiles = [];
+    const MAX_FILES_TO_SCAN = 5000; // 最多扫描5000个文件
+    const MAX_FILE_SIZE = 1 * 1024 * 1024; // 1MB
+    const SAMPLE_LARGE_PROJECTS = true; // 大项目采样
     let totalFiles = 0;
     let totalLines = 0;
+    let skippedFiles = 0;
+    let scannedFiles = 0;
     function scanDirectory(dir) {
+        // 达到文件数量限制
+        if (scannedFiles >= MAX_FILES_TO_SCAN) {
+            return;
+        }
         try {
             const items = readdirSync(dir);
             for (const item of items) {
+                if (scannedFiles >= MAX_FILES_TO_SCAN)
+                    break;
                 const fullPath = join(dir, item);
-                const stat = statSync(fullPath);
+                let stat;
+                try {
+                    stat = statSync(fullPath);
+                }
+                catch {
+                    continue;
+                }
                 if (stat.isDirectory()) {
-                    if (!['node_modules', '.git', 'dist', 'build'].includes(item)) {
+                    const ignoreDirs = [
+                        'node_modules', '.git', 'dist', 'build', '.next', '.nuxt',
+                        'coverage', '.vscode', '.idea', 'tmp', 'temp', 'out',
+                        'vendor', '__pycache__', '.cache', '.parcel-cache',
+                        'bower_components', 'jspm_packages', 'target', 'bin', 'obj'
+                    ];
+                    if (!ignoreDirs.includes(item) && !item.startsWith('.')) {
                         scanDirectory(fullPath);
                     }
                 }
@@ -298,14 +371,27 @@ async function calculateCodeMetrics(projectPath) {
                     const fileType = ext || 'no-extension';
                     fileTypes[fileType] = (fileTypes[fileType] || 0) + 1;
                     totalFiles++;
+                    scannedFiles++;
+                    // 跳过过大的文件
+                    if (stat.size > MAX_FILE_SIZE) {
+                        skippedFiles++;
+                        continue;
+                    }
                     try {
-                        const content = readFileSync(fullPath, 'utf-8');
-                        const lines = content.split('\n').length;
-                        totalLines += lines;
-                        largestFiles.push({ path: fullPath, lines });
+                        // 只读取文本文件
+                        const textExtensions = ['.js', '.ts', '.jsx', '.tsx', '.vue', '.py', '.java', '.go', '.rs', '.php', '.rb', '.cpp', '.c', '.h', '.cs', '.swift', '.kt'];
+                        if (textExtensions.includes(ext.toLowerCase())) {
+                            const content = readFileSync(fullPath, 'utf-8');
+                            const lines = content.split('\n').length;
+                            totalLines += lines;
+                            // 只保存相对路径
+                            const relativePath = fullPath.replace(projectPath, '').replace(/\\/g, '/');
+                            largestFiles.push({ path: relativePath, lines });
+                        }
                     }
                     catch {
-                        // 忽略无法读取的文件
+                        // 忽略无法读取的文件（二进制文件等）
+                        skippedFiles++;
                     }
                 }
             }
@@ -314,14 +400,18 @@ async function calculateCodeMetrics(projectPath) {
             // 忽略无法访问的目录
         }
     }
+    console.error('开始扫描代码文件...');
+    console.error('忽略目录: node_modules, dist, build, .git 等');
     scanDirectory(projectPath);
+    console.error(`扫描完成: ${totalFiles} 个文件, ${skippedFiles} 个跳过`);
     // 按行数排序，取前10个
     largestFiles.sort((a, b) => b.lines - a.lines);
     return {
         totalFiles,
         totalLines,
         fileTypes,
-        largestFiles: largestFiles.slice(0, 10)
+        largestFiles: largestFiles.slice(0, 10),
+        skippedFiles
     };
 }
 async function analyzeArchitecture(projectPath, keyFiles) {

package/build/tools/gencommit.js

@@ -14,8 +14,9 @@ ${changes ? `已提供变更内容：\n${changes}` : `
 
 **第二步：分析变更**
 - 识别变更类型（新功能、修复、重构等）
-- 确定影响范围（哪个模块/功能）
+- 选择对应的 emoji 表情
 - 总结主要变更点
+- 如需要，在 body 中说明影响的模块/范围
 
 ---
 
@@ -23,9 +24,10 @@ ${changes ? `已提供变更内容：\n${changes}` : `
 
 **格式**：
 \`\`\`
-<type>(<scope>): <subject>
+<type>: <emoji> <subject>
 
 <body>
+（可在 body 中说明影响范围和详细变更）
 
 <footer>
 \`\`\`
@@ -41,15 +43,17 @@ ${changes ? `已提供变更内容：\n${changes}` : `
 - test ✅（可选）: 测试相关
 
 **要求**：
-1. subject 使用中文，简洁明了（不超过 50 字）
-2. body 详细说明变更内容（可选）
-3. footer 引用相关 issue（如有）
-4. 如有破坏性变更，添加 BREAKING CHANGE
+1. type 后面加冒号和空格，然后是对应的 emoji
+2. subject 使用中文，简洁明了（不超过 50 字）
+3. body 详细说明变更内容，可包含影响范围、具体改动等（可选）
+4. footer 引用相关 issue（如有）
+5. 如有破坏性变更，添加 BREAKING CHANGE
 
-**示例**：
+**示例 1**（详细版，包含影响范围）：
 \`\`\`
-feat(auth): 🎸 添加用户登录功能
+feat: 🎸 添加用户登录功能
 
+影响模块: auth
 - 实现 JWT 认证机制
 - 添加密码加密存储
 - 实现登录失败重试限制
@@ -57,15 +61,22 @@ feat(auth): 🎸 添加用户登录功能
 Closes #123
 \`\`\`
 
+**示例 2**（包含模块说明）：
 \`\`\`
-fixed(api): 🐛 修复用户数据返回异常
+fixed: 🐛 修复用户数据返回异常
 
+模块: api
 - 修复空值判断逻辑
 - 优化错误处理机制
 
 Closes #456
 \`\`\`
 
+**示例 3**（简洁版）：
+\`\`\`
+chore: 🤖 升级依赖版本至 1.2.9
+\`\`\`
+
 ---
 
 **第三步：生成并提交**

package/build/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION: any;
+export declare const NAME: any;

package/build/version.js

@@ -0,0 +1,11 @@
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+// 获取当前文件的目录
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// 读取 package.json
+const packageJsonPath = join(__dirname, '../package.json');
+const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+export const VERSION = packageJson.version;
+export const NAME = packageJson.name;

package/package.json

@@ -1,65 +1,65 @@
-{
-  "name": "mcp-probe-kit",
-  "version": "1.2.7",
-  "description": "Cursor Development Enhancement Toolkit - MCP Server with 23 practical tools for code quality, development efficiency, and project management",
-  "type": "module",
-  "main": "build/index.js",
-  "bin": {
-    "mcp-probe-kit": "build/index.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "watch": "tsc --watch",
-    "dev": "tsc && node build/index.js",
-    "test": "npm run build && node test-server.js",
-    "inspector": "npx @modelcontextprotocol/inspector node build/index.js",
-    "prepare": "npm run build",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "cursor",
-    "ai-tools",
-    "development-tools",
-    "code-quality",
-    "code-review",
-    "refactor",
-    "debugging",
-    "sql-generator",
-    "ui-generator",
-    "react",
-    "vue",
-    "typescript",
-    "git-tools",
-    "ai-assistant"
-  ],
-  "author": {
-    "name": "小墨 (Kyle)",
-    "url": "https://www.bytezonex.com/"
-  },
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/mybolide/mcp-probe-kit.git"
-  },
-  "bugs": {
-    "url": "https://github.com/mybolide/mcp-probe-kit/issues"
-  },
-  "homepage": "https://github.com/mybolide/mcp-probe-kit#readme",
-  "engines": {
-    "node": ">=16.0.0"
-  },
-  "files": [
-    "build",
-    "README.md",
-    "LICENSE"
-  ],
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^0.5.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "typescript": "^5.3.0"
-  }
-}
+{
+  "name": "mcp-probe-kit",
+  "version": "1.2.9",
+  "description": "Cursor Development Enhancement Toolkit - MCP Server with 23 practical tools for code quality, development efficiency, and project management",
+  "type": "module",
+  "main": "build/index.js",
+  "bin": {
+    "mcp-probe-kit": "build/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "dev": "tsc && node build/index.js",
+    "test": "npm run build && node test-server.js",
+    "inspector": "npx @modelcontextprotocol/inspector node build/index.js",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "cursor",
+    "ai-tools",
+    "development-tools",
+    "code-quality",
+    "code-review",
+    "refactor",
+    "debugging",
+    "sql-generator",
+    "ui-generator",
+    "react",
+    "vue",
+    "typescript",
+    "git-tools",
+    "ai-assistant"
+  ],
+  "author": {
+    "name": "小墨 (Kyle)",
+    "url": "https://www.bytezonex.com/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mybolide/mcp-probe-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mybolide/mcp-probe-kit/issues"
+  },
+  "homepage": "https://github.com/mybolide/mcp-probe-kit#readme",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "files": [
+    "build",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  }
+}