mcp-probe-kit 1.2.4 → 1.2.7

package/README.md

@@ -1,736 +1,808 @@
-# MCP Probe Kit
-
-> 🚀 Cursor 开发增强工具集 - 让 AI 更懂你的开发流程
-
-一个强大的 MCP (Model Context Protocol) 服务器，提供 **23 个实用工具**，覆盖代码质量、开发效率、项目管理全流程。
-
-**作者**: [小墨 (Kyle)](https://www.bytezonex.com/) | **项目**: [GitHub](https://github.com/mybolide/mcp-probe-kit)
-
----
-
-## ✨ 功能特性
-
-### 🔍 代码质量（7 个工具）
-- **`detect_shell`** - AI 模型套壳检测
-- **`code_review`** - 代码审查助手
-- **`debug`** - 智能调试助手
-- **`gentest`** - 测试用例生成器
-- **`refactor`** - 重构建议
-- **`perf`** - 性能分析
-- **`fix`** - 自动修复代码问题 🆕
-
-### 🛠️ 开发效率（11 个工具）
-- **`gencommit`** - Git 提交消息生成
-- **`genapi`** - API 文档生成
-- **`gendoc`** - 代码注释生成
-- **`genpr`** - PR 描述生成
-- **`genchangelog`** - Changelog 生成
-- **`gensql`** - SQL 查询生成器 🆕
-- **`genui`** - UI 组件生成器（React + Vue） 🆕
-- **`explain`** - 代码解释器 🆕
-- **`convert`** - 代码转换器 🆕
-- **`genreadme`** - README 生成器 🆕
-- **`split`** - 文件拆分工具 🆕
-
-### 📦 项目管理（5 个工具）
-- **`init_setting`** - Cursor AI 配置初始化
-- **`init_project`** - Spec-Driven 项目初始化
-- **`check_deps`** - 依赖健康度检查
-- **`resolve_conflict`** - Git 冲突解决助手 🆕
-- **`analyze_project`** - 项目分析工具，帮助AI快速理解老项目 🆕
-
----
-
-## 🚀 快速开始
-
-### 📦 方式一：npx 直接使用（推荐）
-
-无需安装，直接使用：
-
-```bash
-# 在 Cursor 中配置 MCP 服务器
-```
-
-**Windows 配置路径：**
-```
-%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
-```
-
-**macOS/Linux 配置路径：**
-```
-~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
-```
-
-**配置内容：**
-```json
-{
-  "mcpServers": {
-    "mcp-probe-kit": {
-      "command": "npx",
-      "args": ["mcp-probe-kit@latest"],
-      "env": {}
-    }
-  }
-}
-```
-
----
-
-### 📦 方式二：全局安装
-
-```bash
-# 全局安装
-npm install -g mcp-probe-kit
-
-# 在 Cursor 中配置
-```
-
-**配置内容：**
-```json
-{
-  "mcpServers": {
-    "mcp-probe-kit": {
-      "command": "mcp-probe-kit"
-    }
-  }
-}
-```
-
----
-
-### 📦 方式三：本地项目安装
-
-```bash
-# 在项目中安装
-npm install mcp-probe-kit
-
-# 在 Cursor 中配置（使用项目路径）
-```
-
-**配置内容：**
-```json
-{
-  "mcpServers": {
-    "mcp-probe-kit": {
-      "command": "node",
-      "args": ["./node_modules/mcp-probe-kit/build/index.js"]
-    }
-  }
-}
-```
-
----
-
-### 🔧 开发模式（本地开发）
-
-如果你在本地开发或修改工具：
-
-**Windows:**
-```
-%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
-```
-
-**macOS/Linux:**
-```
-~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
-```
-
-**配置内容：**
-```json
-{
-  "mcpServers": {
-    "mcp-probe-kit": {
-      "command": "node",
-      "args": ["D:/workspace/github/mcp-probe-kit/build/index.js"]
-    }
-  }
-}
-```
-
-⚠️ **重要**：将路径修改为你的实际项目路径
-
-### 🔄 重启 Cursor
-
-配置完成后，**完全退出 Cursor 再重新打开**（不是重新加载窗口）
-
----
-
-## 📖 工具使用指南
-
-### 🔍 代码质量工具
-
-#### `detect_shell` - 套壳检测
-检测 AI 模型是否被代理/包装，生成 JSON 指纹验证。
-
-**用法**：`detect_shell`
-
----
-
-#### `code_review` - 代码审查
-全面审查代码质量、安全性、性能和最佳实践。
-
-**用法**：`code_review` 或 `code_review @file.ts`
-
-**审查内容**：代码坏味道、安全漏洞、性能问题、命名规范
-
----
-
-#### `debug` - 调试助手
-分析错误并生成调试策略和解决方案。
-
-**用法**：`debug` 然后粘贴错误信息
-
-**输出**：错误分类、问题定位、调试步骤、解决方案、验证清单
-
----
-
-#### `gentest` - 测试生成
-为代码生成完整的测试用例（支持 Jest/Vitest/Mocha）。
-
-**用法**：`gentest @function.ts`
-
-**生成内容**：单元测试、边界测试、异常测试、Mock 数据
-
----
-
-#### `refactor` - 重构建议
-分析代码并提供重构建议和实施计划。
-
-**用法**：`refactor @messy-code.ts`
-
-**建议内容**：识别代码坏味道、重构步骤、风险评估、预期收益
-
----
-
-#### `perf` - 性能分析
-分析代码性能瓶颈并提供优化建议。
-
-**用法**：`perf @slow-function.ts`
-
-**分析维度**：算法复杂度、内存使用、React 性能、数据库查询
-
----
-
-#### `fix` - 自动修复 🆕
-自动修复代码问题（Lint 错误、TypeScript 类型错误、格式化问题）。
-
-**用法**：`fix @file.ts` 或 `fix`（修复所有文件）
-
-**修复类型**：lint, type, format, import, unused, all（默认）
-
-**功能**：
-- Lint 错误自动修复
-- TypeScript 类型错误修复
-- 代码格式化
-- Import 语句优化
-- 移除未使用代码
-
----
-
-### 🛠️ 开发效率工具
-
-#### `gencommit` - 提交生成
-自动分析代码变更，生成规范的 Git commit 消息。
-
-**用法**：`gencommit`
-
-**格式**：`<type>(<scope>): <subject>` (遵循 Conventional Commits)
-
-**类型**：feat, fix, docs, style, refactor, test, chore
-
----
-
-#### `genapi` - 文档生成
-为代码生成 API 文档（支持 Markdown/OpenAPI/JSDoc）。
-
-**用法**：`genapi @api/user.ts`
-
-**格式**：markdown（默认）, openapi, jsdoc
-
----
-
-#### `gendoc` - 注释生成
-为代码生成详细的 JSDoc/TSDoc 注释。
-
-**用法**：`gendoc @function.ts`
-
-**包含**：函数描述、参数说明、返回值、异常情况、使用示例
-
----
-
-#### `genpr` - PR 生成
-分析变更并生成规范的 Pull Request 描述。
-
-**用法**：`genpr`
-
-**包含**：变更摘要、技术细节、测试说明、注意事项、Checklist
-
----
-
-#### `genchangelog` - Changelog 生成
-根据 commit 历史生成 CHANGELOG.md。
-
-**用法**：`genchangelog v1.2.0`
-
-**格式**：Keep a Changelog 标准
-
----
-
-#### `gensql` - SQL 生成器 🆕
-根据自然语言描述生成 SQL 查询语句。
-
-**用法**：`gensql` 然后描述需求（如："查询购买金额超过平均值的用户"）
-
-**支持**：PostgreSQL, MySQL, SQLite
-
-**功能**：
-- 复杂查询生成（JOIN、子查询、窗口函数）
-- 建表语句生成
-- 索引优化建议
-- 查询性能分析
-
----
-
-#### `genui` - UI 组件生成器（React + Vue） 🆕
-生成 React 或 Vue 3 UI 组件代码。
-
-**用法**：`genui` 然后描述组件（如："创建一个带加载状态的 Button 组件"）
-
-**支持框架**：
-- **React**: Hooks、forwardRef、TypeScript
-- **Vue 3**: Composition API、script setup、TypeScript
-- **HTML**: 原生 JavaScript
-
-**功能**：
-- 完整的组件实现（TypeScript）
-- Tailwind CSS / UnoCSS 样式
-- 可访问性（A11y）支持
-- Props/Emits 类型定义
-- 使用示例和最佳实践
-- 组件库推荐（shadcn/ui、Element Plus 等）
-
----
-
-#### `explain` - 代码解释器 🆕
-详细解释代码逻辑和原理，帮助理解复杂代码。
-
-**用法**：`explain @complex-code.ts`
-
-**解释内容**：
-- 整体功能概述
-- 逐行代码说明
-- 核心原理分析
-- 设计模式识别
-- 时间/空间复杂度
-- 使用场景和注意事项
-
-**适用场景**：
-- 理解遗留代码
-- 学习新框架/库
-- 复杂算法分析
-- Code Review
-
----
-
-#### `convert` - 代码转换器 🆕
-转换代码格式或框架。
-
-**用法**：`convert @file.js` 然后说明转换类型（如："转为 TypeScript"）
-
-**支持转换**：
-- JavaScript → TypeScript
-- Class Component → Hooks
-- Promises → Async/Await
-- CommonJS → ESM
-- CSS → Tailwind CSS
-- Vue 2 → Vue 3
-- JSON → TypeScript Interface
-
----
-
-#### `genreadme` - README 生成器 🆕
-根据项目代码自动生成 README.md 文档。
-
-**用法**：`genreadme` 或提供项目信息
-
-**风格**：standard（标准）, minimal（极简）, detailed（详细）
-
-**包含内容**：
-- 项目简介和徽章
-- 安装和快速开始
-- 功能特性列表
-- 使用示例
-- API 文档
-- 配置说明
-- 贡献指南
-
----
-
-#### `split` - 文件拆分工具 🆕
-将大文件拆分成多个小文件或小组件，提高可维护性。
-
-**用法**：`split @LargeFile.tsx` 或提供文件内容
-
-**拆分策略**：
-- **auto**（自动）- AI 分析最佳拆分方式
-- **type**（按类型）- 分离类型定义、常量、工具函数
-- **function**（按功能）- 将多个独立函数拆分
-- **component**（按组件）- 拆分 React/Vue 组件为子组件
-- **feature**（按模块）- 拆分功能模块（如 Redux store）
-
-**适用场景**：
-- 超过 300 行的文件
-- 职责过多的组件
-- 工具函数大杂烩
-- 难以维护的代码
-
-**提供方案**：
-- 拆分策略分析
-- 建议的目录结构
-- 每个新文件的内容
-- 导入导出关系
-- 迁移步骤
-
----
-
-### 📦 项目管理工具
-
-#### `init_setting` - 配置初始化
-在当前项目创建 Cursor AI 配置文件。
-
-**用法**：`init_setting`
-
-**配置**：Claude Sonnet 4.5, temperature=0, semantic 检索
-
----
-
-#### `init_project` - 项目初始化
-按 Spec-Driven Development 方式初始化项目。
-
-**用法**：`init_project，需求是：创建任务管理系统` 或 `init_project @requirements.md`
-
-**生成**：constitution.md, spec.md, plan.md, tasks.md, research.md
-
-**参考**：[GitHub Spec-Kit](https://github.com/github/spec-kit)
-
----
-
-#### `check_deps` - 依赖检查
-分析项目依赖的健康度（版本、安全、体积）。
-
-**用法**：`check_deps`
-
-**检查**：过期依赖、安全漏洞、包体积、未使用依赖
-
----
-
-#### `resolve_conflict` - Git 冲突解决 🆕
-分析并帮助解决 Git 合并冲突。
-
-**用法**：`resolve_conflict` 然后粘贴冲突内容，或直接打开冲突文件
-
-**功能**：
-- 冲突原因分析
-- 双方修改意图识别
-- 推荐合并方案
-- 完整的解决后代码
-- 冲突预防建议
-
-**适用场景**：
-- Feature 分支合并
-- Rebase 冲突
-- Cherry-pick 冲突
-
----
-
-#### `analyze_project` - 项目分析工具 🆕
-深度分析项目结构、代码质量和架构，帮助AI快速理解老项目。
-
-**用法**：`analyze_project` 或 `analyze_project @project-path`
-
-**参数**：
-- `project_path` - 项目路径（默认当前目录）
-- `max_depth` - 目录树最大深度（默认 5）
-- `include_content` - 是否包含文件内容（默认 true）
-
-**分析内容**：
-- **项目概览**：项目类型、技术栈、框架、语言、包管理器
-- **目录结构**：清晰的目录树展示
-- **关键文件**：自动识别重要配置文件并提供用途说明
-- **依赖分析**：生产依赖、开发依赖统计和健康度评估
-- **代码指标**：文件数量、行数统计、文件类型分布、最大文件识别
-- **架构模式**：设计模式检测、入口文件识别、核心模块分析
-- **智能建议**：项目复杂度评估和改进建议
-
-**适用场景**：
-- 🔍 接手老项目时快速了解项目结构
-- 📊 代码审查前进行项目概览
-- 🏗️ 架构分析和重构规划
-- 📚 项目文档生成
-- 🤖 AI助手更好地理解项目上下文
-
-
----
-
-## 🎯 使用场景示例
-
-### 📝 日常开发流程
-```
-1. code_review @feature.ts     # 代码提交前审查
-2. gentest @feature.ts          # 生成测试用例
-3. genapi @api/user.ts          # 生成 API 文档
-4. gencommit                    # 提交代码
-```
-
-### 🐛 调试流程
-```
-1. debug                        # 分析错误
-2. refactor @buggy-code.ts      # 重构建议
-3. gentest @fixed-code.ts       # 补充测试
-4. gencommit                    # 提交修复
-```
-
-### 🚀 新项目启动
-```
-1. init_project @requirements.md  # 初始化项目结构
-2. init_setting                   # 配置 AI
-3. check_deps                     # 检查依赖健康度
-4. 开始开发...
-```
-
-### 🔍 接手老项目
-```
-1. analyze_project                # 深度分析项目结构
-2. check_deps                     # 检查依赖健康度
-3. code_review                    # 代码质量审查
-4. 开始维护和开发...
-```
-
-### 📦 版本发布
-```
-1. code_review                  # 全面代码审查
-2. genchangelog v1.2.0          # 生成 Changelog
-3. genpr                        # 生成 PR 描述
-4. 发布版本
-```
-
-### 🔍 性能优化
-```
-1. perf @slow-function.ts       # 性能分析
-2. refactor @slow-function.ts   # 重构优化
-3. gentest @optimized.ts        # 测试验证
-4. gencommit                    # 提交优化
-```
-
----
-
-## 🛠️ 开发指南
-
-### 项目结构
-```
-mcp-probe-kit/
-├── src/
-│   ├── index.ts              # MCP 服务器主入口
-│   └── tools/                # 工具实现（23 个）
-│       ├── index.ts             # 工具导出
-│       ├── detect_shell.ts      # 套壳检测
-│       ├── code_review.ts       # 代码审查
-│       ├── debug.ts             # 调试助手
-│       ├── gentest.ts           # 测试生成
-│       ├── refactor.ts          # 重构建议
-│       ├── perf.ts              # 性能分析
-│       ├── fix.ts               # 自动修复
-│       ├── gencommit.ts         # 提交生成
-│       ├── genapi.ts            # 文档生成
-│       ├── gendoc.ts            # 注释生成
-│       ├── genpr.ts             # PR 生成
-│       ├── genchangelog.ts      # Changelog 生成
-│       ├── gensql.ts            # SQL 生成器
-│       ├── genui.ts             # UI 组件生成器
-│       ├── explain.ts           # 代码解释器
-│       ├── convert.ts           # 代码转换器
-│       ├── genreadme.ts         # README 生成器
-│       ├── split.ts             # 文件拆分工具
-│       ├── init_setting.ts      # 配置初始化
-│       ├── init_project.ts      # 项目初始化
-│       ├── check_deps.ts        # 依赖检查
-│       ├── resolve_conflict.ts  # Git 冲突解决
-│       └── analyze_project.ts   # 项目分析
-├── build/                    # 编译输出
-├── package.json
-├── tsconfig.json
-└── README.md
-```
-
-### 添加新工具
-
-1. **创建工具文件**：`src/tools/your_tool.ts`
-```typescript
-export async function yourTool(args: any) {
-  try {
-    const message = `你的指令内容...`;
-    return {
-      content: [{ type: "text", text: message }],
-    };
-  } catch (error) {
-    return {
-      content: [{ type: "text", text: `❌ 错误: ${error}` }],
-      isError: true,
-    };
-  }
-}
-```
-
-2. **导出工具**：在 `src/tools/index.ts` 中添加
-```typescript
-export { yourTool } from "./your_tool.js";
-```
-
-3. **注册工具**：在 `src/index.ts` 中添加工具定义和处理
-
-4. **重新构建**：
-```bash
-npm run build
-```
-
-### 开发命令
-
-```bash
-# 安装依赖
-npm install
-
-# 编译
-npm run build
-
-# 监听模式（开发时使用）
-npm run watch
-
-# 测试服务器
-npm run dev
-```
-
----
-
-## 🔧 配置说明
-
-### MCP 服务器配置
-
-配置文件位置（根据你的 MCP 客户端）：
-- **Cursor**: `cline_mcp_settings.json`
-- **Claude Desktop**: `claude_desktop_config.json`
-
-### 工具参数说明
-
-所有工具的参数都是**可选的**，AI 会自动推断。常用参数：
-
-| 工具 | 参数 | 说明 |
-|------|------|------|
-| detect_shell | nonce | 自定义 nonce 字符串 |
-| code_review | focus | quality/security/performance/all |
-| gentest | framework | jest/vitest/mocha |
-| genapi | format | markdown/openapi/jsdoc |
-| gendoc | style, lang | jsdoc/tsdoc, zh/en |
-| genchangelog | version | 版本号（如 v1.2.0） |
-| init_project | input | 项目需求描述 |
-| perf | type | algorithm/memory/react/database |
-
----
-
-## 🤝 贡献指南
-
-欢迎提交 Issue 和 Pull Request！
-
-**改进建议：**
-- 新增实用工具
-- 优化现有工具的提示词
-- 改进文档和示例
-- 修复 Bug
-
-**开发规范：**
-- 遵循 TypeScript 规范
-- 工具命名简洁（建议 10 字符以内）
-- 提供清晰的使用说明和示例
-- 保持"指令生成器"模式（不直接操作文件系统）
-
----
-
-## 📄 License
-
-MIT License
-
----
-
-## 🔗 相关链接
-
-- [Model Context Protocol (MCP)](https://modelcontextprotocol.io/)
-- [GitHub Spec-Kit](https://github.com/github/spec-kit)
-- [Conventional Commits](https://www.conventionalcommits.org/)
-- [OpenAPI Specification](https://swagger.io/specification/)
-
----
-
-## 💡 设计理念
-
-### 指令生成器模式
-
-所有工具都采用**指令生成器模式**：
-- 工具不直接操作文件系统或执行命令
-- 而是生成清晰的指令告诉 AI 需要做什么
-- AI 理解指令后，使用 Cursor 的能力完成实际操作
-
-**优势：**
-- ✅ 代码简洁，易于维护
-- ✅ AI 可以智能处理边界情况
-- ✅ 用户可见操作过程，更透明
-- ✅ 灵活性强，AI 可以根据实际情况调整
-
-### 为什么叫 Probe Kit？
-
-- **Probe（探针）**：探测代码质量、性能瓶颈、依赖健康度
-- **Kit（工具集）**：23 个工具覆盖开发全流程
-
-### 工具分类
-
-```
-代码质量 (7)
-├── detect_shell  套壳检测
-├── code_review   代码审查
-├── debug         调试助手
-├── gentest       测试生成
-├── refactor      重构建议
-├── perf          性能分析
-└── fix           自动修复
-
-开发效率 (11)
-├── gencommit     提交生成
-├── genapi        文档生成
-├── gendoc        注释生成
-├── genpr         PR 生成
-├── genchangelog  Changelog 生成
-├── gensql        SQL 生成器
-├── genui         UI 组件生成器
-├── explain       代码解释器
-├── convert       代码转换器
-├── genreadme     README 生成器
-└── split         文件拆分工具
-
-项目管理 (5)
-├── init_setting     配置初始化
-├── init_project     项目初始化
-├── check_deps       依赖检查
-├── resolve_conflict Git 冲突解决
-└── analyze_project  项目分析工具
-```
-
----
-
-## 👨‍💻 作者
-
-**小墨 (Kyle)**
-
-- 🌐 Website: [bytezonex.com](https://www.bytezonex.com/)
-- 💼 专注于 AI 辅助开发工具
-
----
-
-**Made with ❤️ for Cursor Users**
+# MCP Probe Kit
+
+> 🚀 Cursor 开发增强工具集 - 让 AI 更懂你的开发流程
+
+一个强大的 MCP (Model Context Protocol) 服务器，提供 **23 个实用工具**，覆盖代码质量、开发效率、项目管理全流程。
+
+**作者**: [小墨 (Kyle)](https://www.bytezonex.com/) | **项目**: [GitHub](https://github.com/mybolide/mcp-probe-kit)
+
+---
+
+## ✨ 功能特性
+
+### 🔍 代码质量（7 个工具）
+- **`detect_shell`** - AI 模型套壳检测
+- **`code_review`** - 代码审查助手
+- **`debug`** - 智能调试助手
+- **`gentest`** - 测试用例生成器
+- **`refactor`** - 重构建议
+- **`perf`** - 性能分析
+- **`fix`** - 自动修复代码问题 🆕
+
+### 🛠️ 开发效率（11 个工具）
+- **`gencommit`** - Git 提交消息生成
+- **`genapi`** - API 文档生成
+- **`gendoc`** - 代码注释生成
+- **`genpr`** - PR 描述生成
+- **`genchangelog`** - Changelog 生成
+- **`gensql`** - SQL 查询生成器 🆕
+- **`genui`** - UI 组件生成器（React + Vue） 🆕
+- **`explain`** - 代码解释器 🆕
+- **`convert`** - 代码转换器 🆕
+- **`genreadme`** - README 生成器 🆕
+- **`split`** - 文件拆分工具 🆕
+
+### 📦 项目管理（5 个工具）
+- **`init_setting`** - Cursor AI 配置初始化
+- **`init_project`** - Spec-Driven 项目初始化
+- **`check_deps`** - 依赖健康度检查
+- **`resolve_conflict`** - Git 冲突解决助手 🆕
+- **`analyze_project`** - 项目分析工具，帮助AI快速理解老项目 🆕
+
+---
+
+## 🚀 快速开始
+
+### 📦 方式一：npx 直接使用（推荐）
+
+无需安装，直接使用：
+
+```bash
+# 在 Cursor 中配置 MCP 服务器
+```
+
+**Windows 配置路径：**
+```
+%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
+```
+
+**macOS/Linux 配置路径：**
+```
+~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
+```
+
+**配置内容：**
+```json
+{
+  "mcpServers": {
+    "mcp-probe-kit": {
+      "command": "npx",
+      "args": ["mcp-probe-kit@latest"],
+      "env": {}
+    }
+  }
+}
+```
+
+---
+
+### 📦 方式二：全局安装
+
+```bash
+# 全局安装
+npm install -g mcp-probe-kit
+
+# 在 Cursor 中配置
+```
+
+**配置内容：**
+```json
+{
+  "mcpServers": {
+    "mcp-probe-kit": {
+      "command": "mcp-probe-kit"
+    }
+  }
+}
+```
+
+---
+
+### 📦 方式三：本地项目安装
+
+```bash
+# 在项目中安装
+npm install mcp-probe-kit
+
+# 在 Cursor 中配置（使用项目路径）
+```
+
+**配置内容：**
+```json
+{
+  "mcpServers": {
+    "mcp-probe-kit": {
+      "command": "node",
+      "args": ["./node_modules/mcp-probe-kit/build/index.js"]
+    }
+  }
+}
+```
+
+---
+
+### 🔧 开发模式（本地开发）
+
+如果你在本地开发或修改工具：
+
+**Windows:**
+```
+%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
+```
+
+**macOS/Linux:**
+```
+~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
+```
+
+**配置内容：**
+```json
+{
+  "mcpServers": {
+    "mcp-probe-kit": {
+      "command": "node",
+      "args": ["D:/workspace/github/mcp-probe-kit/build/index.js"]
+    }
+  }
+}
+```
+
+⚠️ **重要**：将路径修改为你的实际项目路径
+
+### 🔄 重启 Cursor
+
+配置完成后，**完全退出 Cursor 再重新打开**（不是重新加载窗口）
+
+---
+
+## 📖 工具使用指南
+
+### 🔍 代码质量工具
+
+#### `detect_shell` - 套壳检测
+检测 AI 模型是否被代理/包装，生成 JSON 指纹验证。
+
+**用法**：`detect_shell`
+
+---
+
+#### `code_review` - 代码审查
+全面审查代码质量、安全性、性能和最佳实践。
+
+**用法**：`code_review` 或 `code_review @file.ts`
+
+**审查内容**：代码坏味道、安全漏洞、性能问题、命名规范
+
+---
+
+#### `debug` - 调试助手
+分析错误并生成调试策略和解决方案。
+
+**用法**：`debug` 然后粘贴错误信息
+
+**输出**：错误分类、问题定位、调试步骤、解决方案、验证清单
+
+---
+
+#### `gentest` - 测试生成
+为代码生成完整的测试用例（支持 Jest/Vitest/Mocha）。
+
+**用法**：`gentest @function.ts`
+
+**生成内容**：单元测试、边界测试、异常测试、Mock 数据
+
+---
+
+#### `refactor` - 重构建议
+分析代码并提供重构建议和实施计划。
+
+**用法**：`refactor @messy-code.ts`
+
+**建议内容**：识别代码坏味道、重构步骤、风险评估、预期收益
+
+---
+
+#### `perf` - 性能分析
+分析代码性能瓶颈并提供优化建议。
+
+**用法**：`perf @slow-function.ts`
+
+**分析维度**：算法复杂度、内存使用、React 性能、数据库查询
+
+---
+
+#### `fix` - 自动修复 🆕
+自动修复代码问题（Lint 错误、TypeScript 类型错误、格式化问题）。
+
+**用法**：`fix @file.ts` 或 `fix`（修复所有文件）
+
+**修复类型**：lint, type, format, import, unused, all（默认）
+
+**功能**：
+- Lint 错误自动修复
+- TypeScript 类型错误修复
+- 代码格式化
+- Import 语句优化
+- 移除未使用代码
+
+---
+
+### 🛠️ 开发效率工具
+
+#### `gencommit` - 提交生成
+自动分析代码变更，生成规范的 Git commit 消息。
+
+**用法**：`gencommit`
+
+**格式**：`<type>(<scope>): <subject>` (遵循 Conventional Commits)
+
+**类型**：feat, fix, docs, style, refactor, test, chore
+
+---
+
+#### `genapi` - 文档生成
+为代码生成 API 文档（支持 Markdown/OpenAPI/JSDoc）。
+
+**用法**：`genapi @api/user.ts`
+
+**格式**：markdown（默认）, openapi, jsdoc
+
+---
+
+#### `gendoc` - 注释生成
+为代码生成详细的 JSDoc/TSDoc 注释。
+
+**用法**：`gendoc @function.ts`
+
+**包含**：函数描述、参数说明、返回值、异常情况、使用示例
+
+---
+
+#### `genpr` - PR 生成
+分析变更并生成规范的 Pull Request 描述。
+
+**用法**：`genpr`
+
+**包含**：变更摘要、技术细节、测试说明、注意事项、Checklist
+
+---
+
+#### `genchangelog` - Changelog 生成
+根据 commit 历史生成 CHANGELOG.md。
+
+**用法**：`genchangelog v1.2.0`
+
+**格式**：Keep a Changelog 标准
+
+---
+
+#### `gensql` - SQL 生成器 🆕
+根据自然语言描述生成 SQL 查询语句。
+
+**用法**：`gensql` 然后描述需求（如："查询购买金额超过平均值的用户"）
+
+**支持**：PostgreSQL, MySQL, SQLite
+
+**功能**：
+- 复杂查询生成（JOIN、子查询、窗口函数）
+- 建表语句生成
+- 索引优化建议
+- 查询性能分析
+
+---
+
+#### `genui` - UI 组件生成器（React + Vue） 🆕
+生成 React 或 Vue 3 UI 组件代码。
+
+**用法**：`genui` 然后描述组件（如："创建一个带加载状态的 Button 组件"）
+
+**支持框架**：
+- **React**: Hooks、forwardRef、TypeScript
+- **Vue 3**: Composition API、script setup、TypeScript
+- **HTML**: 原生 JavaScript
+
+**功能**：
+- 完整的组件实现（TypeScript）
+- Tailwind CSS / UnoCSS 样式
+- 可访问性（A11y）支持
+- Props/Emits 类型定义
+- 使用示例和最佳实践
+- 组件库推荐（shadcn/ui、Element Plus 等）
+
+---
+
+#### `explain` - 代码解释器 🆕
+详细解释代码逻辑和原理，帮助理解复杂代码。
+
+**用法**：`explain @complex-code.ts`
+
+**解释内容**：
+- 整体功能概述
+- 逐行代码说明
+- 核心原理分析
+- 设计模式识别
+- 时间/空间复杂度
+- 使用场景和注意事项
+
+**适用场景**：
+- 理解遗留代码
+- 学习新框架/库
+- 复杂算法分析
+- Code Review
+
+---
+
+#### `convert` - 代码转换器 🆕
+转换代码格式或框架。
+
+**用法**：`convert @file.js` 然后说明转换类型（如："转为 TypeScript"）
+
+**支持转换**：
+- JavaScript → TypeScript
+- Class Component → Hooks
+- Promises → Async/Await
+- CommonJS → ESM
+- CSS → Tailwind CSS
+- Vue 2 → Vue 3
+- JSON → TypeScript Interface
+
+---
+
+#### `genreadme` - README 生成器 🆕
+根据项目代码自动生成 README.md 文档。
+
+**用法**：`genreadme` 或提供项目信息
+
+**风格**：standard（标准）, minimal（极简）, detailed（详细）
+
+**包含内容**：
+- 项目简介和徽章
+- 安装和快速开始
+- 功能特性列表
+- 使用示例
+- API 文档
+- 配置说明
+- 贡献指南
+
+---
+
+#### `split` - 文件拆分工具 🆕
+将大文件拆分成多个小文件或小组件，提高可维护性。
+
+**用法**：`split @LargeFile.tsx` 或提供文件内容
+
+**拆分策略**：
+- **auto**（自动）- AI 分析最佳拆分方式
+- **type**（按类型）- 分离类型定义、常量、工具函数
+- **function**（按功能）- 将多个独立函数拆分
+- **component**（按组件）- 拆分 React/Vue 组件为子组件
+- **feature**（按模块）- 拆分功能模块（如 Redux store）
+
+**适用场景**：
+- 超过 300 行的文件
+- 职责过多的组件
+- 工具函数大杂烩
+- 难以维护的代码
+
+**提供方案**：
+- 拆分策略分析
+- 建议的目录结构
+- 每个新文件的内容
+- 导入导出关系
+- 迁移步骤
+
+---
+
+### 📦 项目管理工具
+
+#### `init_setting` - 配置初始化
+在当前项目创建 Cursor AI 配置文件。
+
+**用法**：`init_setting`
+
+**配置**：Claude Sonnet 4.5, temperature=0, semantic 检索
+
+---
+
+#### `init_project` - 项目初始化
+按 Spec-Driven Development 方式初始化项目。
+
+**用法**：`init_project，需求是：创建任务管理系统` 或 `init_project @requirements.md`
+
+**生成**：constitution.md, spec.md, plan.md, tasks.md, research.md
+
+**参考**：[GitHub Spec-Kit](https://github.com/github/spec-kit)
+
+---
+
+#### `check_deps` - 依赖检查
+分析项目依赖的健康度（版本、安全、体积）。
+
+**用法**：`check_deps`
+
+**检查**：过期依赖、安全漏洞、包体积、未使用依赖
+
+---
+
+#### `resolve_conflict` - Git 冲突解决 🆕
+分析并帮助解决 Git 合并冲突。
+
+**用法**：`resolve_conflict` 然后粘贴冲突内容，或直接打开冲突文件
+
+**功能**：
+- 冲突原因分析
+- 双方修改意图识别
+- 推荐合并方案
+- 完整的解决后代码
+- 冲突预防建议
+
+**适用场景**：
+- Feature 分支合并
+- Rebase 冲突
+- Cherry-pick 冲突
+
+---
+
+#### `analyze_project` - 项目分析工具 🆕
+深度分析项目结构、代码质量和架构，帮助AI快速理解老项目。
+
+**用法**：`analyze_project` 或 `analyze_project @project-path`
+
+**参数**：
+- `project_path` - 项目路径（默认当前目录）
+- `max_depth` - 目录树最大深度（默认 5）
+- `include_content` - 是否包含文件内容（默认 true）
+
+**分析内容**：
+- **项目概览**：项目类型、技术栈、框架、语言、包管理器
+- **目录结构**：清晰的目录树展示
+- **关键文件**：自动识别重要配置文件并提供用途说明
+- **依赖分析**：生产依赖、开发依赖统计和健康度评估
+- **代码指标**：文件数量、行数统计、文件类型分布、最大文件识别
+- **架构模式**：设计模式检测、入口文件识别、核心模块分析
+- **智能建议**：项目复杂度评估和改进建议
+
+**适用场景**：
+- 🔍 接手老项目时快速了解项目结构
+- 📊 代码审查前进行项目概览
+- 🏗️ 架构分析和重构规划
+- 📚 项目文档生成
+- 🤖 AI助手更好地理解项目上下文
+
+
+---
+
+## 🎯 使用场景示例
+
+### 📝 日常开发流程
+```
+1. code_review @feature.ts     # 代码提交前审查
+2. gentest @feature.ts          # 生成测试用例
+3. genapi @api/user.ts          # 生成 API 文档
+4. gencommit                    # 提交代码
+```
+
+### 🐛 调试流程
+```
+1. debug                        # 分析错误
+2. refactor @buggy-code.ts      # 重构建议
+3. gentest @fixed-code.ts       # 补充测试
+4. gencommit                    # 提交修复
+```
+
+### 🚀 新项目启动
+```
+1. init_project @requirements.md  # 初始化项目结构
+2. init_setting                   # 配置 AI
+3. check_deps                     # 检查依赖健康度
+4. 开始开发...
+```
+
+### 🔍 接手老项目
+```
+1. analyze_project                # 深度分析项目结构
+2. check_deps                     # 检查依赖健康度
+3. code_review                    # 代码质量审查
+4. 开始维护和开发...
+```
+
+### 📦 版本发布
+```
+1. code_review                  # 全面代码审查
+2. genchangelog v1.2.0          # 生成 Changelog
+3. genpr                        # 生成 PR 描述
+4. 发布版本
+```
+
+### 🔍 性能优化
+```
+1. perf @slow-function.ts       # 性能分析
+2. refactor @slow-function.ts   # 重构优化
+3. gentest @optimized.ts        # 测试验证
+4. gencommit                    # 提交优化
+```
+
+---
+
+## 🛠️ 开发指南
+
+### 项目结构
+```
+mcp-probe-kit/
+├── src/
+│   ├── index.ts              # MCP 服务器主入口
+│   └── tools/                # 工具实现（23 个）
+│       ├── index.ts             # 工具导出
+│       ├── detect_shell.ts      # 套壳检测
+│       ├── code_review.ts       # 代码审查
+│       ├── debug.ts             # 调试助手
+│       ├── gentest.ts           # 测试生成
+│       ├── refactor.ts          # 重构建议
+│       ├── perf.ts              # 性能分析
+│       ├── fix.ts               # 自动修复
+│       ├── gencommit.ts         # 提交生成
+│       ├── genapi.ts            # 文档生成
+│       ├── gendoc.ts            # 注释生成
+│       ├── genpr.ts             # PR 生成
+│       ├── genchangelog.ts      # Changelog 生成
+│       ├── gensql.ts            # SQL 生成器
+│       ├── genui.ts             # UI 组件生成器
+│       ├── explain.ts           # 代码解释器
+│       ├── convert.ts           # 代码转换器
+│       ├── genreadme.ts         # README 生成器
+│       ├── split.ts             # 文件拆分工具
+│       ├── init_setting.ts      # 配置初始化
+│       ├── init_project.ts      # 项目初始化
+│       ├── check_deps.ts        # 依赖检查
+│       ├── resolve_conflict.ts  # Git 冲突解决
+│       └── analyze_project.ts   # 项目分析
+├── build/                    # 编译输出
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+### 添加新工具
+
+1. **创建工具文件**：`src/tools/your_tool.ts`
+```typescript
+export async function yourTool(args: any) {
+  try {
+    const message = `你的指令内容...`;
+    return {
+      content: [{ type: "text", text: message }],
+    };
+  } catch (error) {
+    return {
+      content: [{ type: "text", text: `❌ 错误: ${error}` }],
+      isError: true,
+    };
+  }
+}
+```
+
+2. **导出工具**：在 `src/tools/index.ts` 中添加
+```typescript
+export { yourTool } from "./your_tool.js";
+```
+
+3. **注册工具**：在 `src/index.ts` 中添加工具定义和处理
+
+4. **重新构建**：
+```bash
+npm run build
+```
+
+### 开发命令
+
+```bash
+# 安装依赖
+npm install
+
+# 编译
+npm run build
+
+# 监听模式（开发时使用）
+npm run watch
+
+# 测试服务器
+npm run dev
+```
+
+---
+
+## 🔧 配置说明
+
+### MCP 服务器配置
+
+配置文件位置（根据你的 MCP 客户端）：
+- **Cursor**: `cline_mcp_settings.json`
+- **Claude Desktop**: `claude_desktop_config.json`
+
+### 工具参数说明
+
+所有工具的参数都是**可选的**，AI 会自动推断。常用参数：
+
+| 工具 | 参数 | 说明 |
+|------|------|------|
+| detect_shell | nonce | 自定义 nonce 字符串 |
+| code_review | focus | quality/security/performance/all |
+| gentest | framework | jest/vitest/mocha |
+| genapi | format | markdown/openapi/jsdoc |
+| gendoc | style, lang | jsdoc/tsdoc, zh/en |
+| genchangelog | version | 版本号（如 v1.2.0） |
+| init_project | input | 项目需求描述 |
+| perf | type | algorithm/memory/react/database |
+
+---
+
+## ❓ 常见问题
+
+### Q1: 工具无法使用或报错怎么办？
+
+如果遇到安装或运行问题，可以通过以下方式输出详细日志进行排查：
+
+**Windows (PowerShell):**
+```powershell
+npx -y mcp-probe-kit@latest 2>&1 | Tee-Object -FilePath .\mcp-probe-kit.log
+```
+
+**macOS/Linux:**
+```bash
+npx -y mcp-probe-kit@latest 2>&1 | tee ./mcp-probe-kit.log
+```
+
+这会将错误信息保存到 `mcp-probe-kit.log` 文件中，方便排查问题或提交 Issue。
+
+### Q2: 配置后 Cursor 无法识别工具？
+
+1. **完全退出 Cursor** 并重新打开（不是重新加载窗口）
+2. 检查配置文件路径是否正确：
+   - Windows: `%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
+   - macOS/Linux: `~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
+3. 确认 JSON 格式正确，没有语法错误
+4. 查看 Cursor 的开发者工具（Help → Toggle Developer Tools）中的控制台日志
+
+### Q3: npx 方式每次都很慢？
+
+建议全局安装以提升速度：
+```bash
+npm install -g mcp-probe-kit
+```
+
+然后修改配置为：
+```json
+{
+  "mcpServers": {
+    "mcp-probe-kit": {
+      "command": "mcp-probe-kit"
+    }
+  }
+}
+```
+
+### Q4: 工具生成的内容不符合预期？
+
+所有工具都是**指令生成器**，生成的是给 AI 的指令：
+- AI 会根据指令理解你的需求
+- 可以在对话中进一步说明具体要求
+- 例如："用 React Hooks 实现"、"添加 TypeScript 类型"等
+
+### Q5: 如何更新到最新版本？
+
+**npx 方式（推荐）:**
+配置中使用 `@latest` 标签，会自动使用最新版本：
+```json
+"args": ["mcp-probe-kit@latest"]
+```
+
+**全局安装方式:**
+```bash
+npm update -g mcp-probe-kit
+```
+
+**查看当前版本:**
+```bash
+npm list -g mcp-probe-kit
+```
+
+---
+
+## 🤝 贡献指南
+
+欢迎提交 Issue 和 Pull Request！
+
+**改进建议：**
+- 新增实用工具
+- 优化现有工具的提示词
+- 改进文档和示例
+- 修复 Bug
+
+**开发规范：**
+- 遵循 TypeScript 规范
+- 工具命名简洁（建议 10 字符以内）
+- 提供清晰的使用说明和示例
+- 保持"指令生成器"模式（不直接操作文件系统）
+
+---
+
+## 📄 License
+
+MIT License
+
+---
+
+## 🔗 相关链接
+
+- [Model Context Protocol (MCP)](https://modelcontextprotocol.io/)
+- [GitHub Spec-Kit](https://github.com/github/spec-kit)
+- [Conventional Commits](https://www.conventionalcommits.org/)
+- [OpenAPI Specification](https://swagger.io/specification/)
+
+---
+
+## 💡 设计理念
+
+### 指令生成器模式
+
+所有工具都采用**指令生成器模式**：
+- 工具不直接操作文件系统或执行命令
+- 而是生成清晰的指令告诉 AI 需要做什么
+- AI 理解指令后，使用 Cursor 的能力完成实际操作
+
+**优势：**
+- ✅ 代码简洁，易于维护
+- ✅ AI 可以智能处理边界情况
+- ✅ 用户可见操作过程，更透明
+- ✅ 灵活性强，AI 可以根据实际情况调整
+
+### 为什么叫 Probe Kit？
+
+- **Probe（探针）**：探测代码质量、性能瓶颈、依赖健康度
+- **Kit（工具集）**：23 个工具覆盖开发全流程
+
+### 工具分类
+
+```
+代码质量 (7)
+├── detect_shell  套壳检测
+├── code_review   代码审查
+├── debug         调试助手
+├── gentest       测试生成
+├── refactor      重构建议
+├── perf          性能分析
+└── fix           自动修复
+
+开发效率 (11)
+├── gencommit     提交生成
+├── genapi        文档生成
+├── gendoc        注释生成
+├── genpr         PR 生成
+├── genchangelog  Changelog 生成
+├── gensql        SQL 生成器
+├── genui         UI 组件生成器
+├── explain       代码解释器
+├── convert       代码转换器
+├── genreadme     README 生成器
+└── split         文件拆分工具
+
+项目管理 (5)
+├── init_setting     配置初始化
+├── init_project     项目初始化
+├── check_deps       依赖检查
+├── resolve_conflict Git 冲突解决
+└── analyze_project  项目分析工具
+```
+
+---
+
+## 👨‍💻 作者
+
+**小墨 (Kyle)**
+
+- 🌐 Website: [bytezonex.com](https://www.bytezonex.com/)
+- 💼 专注于 AI 辅助开发工具
+
+---
+
+**Made with ❤️ for Cursor Users**