MCP Probe Kit

🚀 MCP Probe Kit

MCP Probe Kit 是一款强大的 Cursor 开发增强工具集，它基于 MCP（Model Context Protocol）服务器，提供 23 个实用工具，全面覆盖代码质量、开发效率和项目管理等开发全流程，能让 AI 更好地理解你的开发需求，显著提升开发体验。

作者: 小墨 (Kyle) | 项目: GitHub

🚀 快速开始

📦 方式一：npx 直接使用（推荐）

无需安装，直接使用：

# 在 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

配置内容：

{
  "mcpServers": {
    "mcp-probe-kit": {
      "command": "npx",
      "args": ["mcp-probe-kit@latest"],
      "env": {}
    }
  }
}

📦 方式二：全局安装

# 全局安装
npm install -g mcp-probe-kit

# 在 Cursor 中配置

配置内容：

{
  "mcpServers": {
    "mcp-probe-kit": {
      "command": "mcp-probe-kit"
    }
  }
}

📦 方式三：本地项目安装

# 在项目中安装
npm install mcp-probe-kit

# 在 Cursor 中配置（使用项目路径）

配置内容：

{
  "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

配置内容：

{
  "mcpServers": {
    "mcp-probe-kit": {
      "command": "node",
      "args": ["D:/workspace/github/mcp-probe-kit/build/index.js"]
    }
  }
}

⚠️ 重要：将路径修改为你的实际项目路径

🔄 重启 Cursor

配置完成后，完全退出 Cursor 再重新打开（不是重新加载窗口）

✨ 主要特性

🔍 代码质量（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快速理解老项目 🆕

📖 详细文档

📖 工具使用指南

🔍 代码质量工具

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 消息（支持 emoji）。 用法：gencommit 格式：<type>: <emoji> <subject> (遵循 Conventional Commits) 类型：

• fixed 🐛 - 线上/测试缺陷修复
• fix 🐛 - 语义同 fixed，保持兼容
• feat 🎸 - 新增或迭代业务功能
• docs ✏️ - 文档相关更新
• style 💄 - UI/样式调整
• chore 🤖 - 构建、脚本、依赖等杂项
• refactor ♻️ - 重构
• test ✅ - 测试相关 示例：

feat: 🎸 添加用户登录功能

影响模块: auth
- 实现 JWT 认证机制
- 添加密码加密存储

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

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

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 中添加

export { yourTool } from "./your_tool.js";

3. 注册工具：在 src/index.ts 中添加工具定义和处理

4. 重新构建：

npm run build

开发命令

# 安装依赖
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):

npx -y mcp-probe-kit@latest 2>&1 | Tee-Object -FilePath .\mcp-probe-kit.log

macOS/Linux:

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 方式每次都很慢？

建议全局安装以提升速度：

npm install -g mcp-probe-kit

然后修改配置为：

{
  "mcpServers": {
    "mcp-probe-kit": {
      "command": "mcp-probe-kit"
    }
  }
}

Q4: 工具生成的内容不符合预期？

所有工具都是指令生成器，生成的是给 AI 的指令：

• AI 会根据指令理解你的需求
• 可以在对话中进一步说明具体要求
• 例如："用 React Hooks 实现"、"添加 TypeScript 类型"等

Q5: 如何更新到最新版本？

npx 方式（推荐）: 配置中使用 @latest 标签，会自动使用最新版本：

"args": ["mcp-probe-kit@latest"]

全局安装方式:

npm update -g mcp-probe-kit

查看当前版本:

npm list -g mcp-probe-kit

💡 设计理念

指令生成器模式

所有工具都采用指令生成器模式：

• 工具不直接操作文件系统或执行命令
• 而是生成清晰的指令告诉 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  项目分析工具

🤝 贡献指南

欢迎提交 Issue 和 Pull Request！ 改进建议：

• 新增实用工具
• 优化现有工具的提示词
• 改进文档和示例
• 修复 Bug 开发规范：
• 遵循 TypeScript 规范
• 工具命名简洁（建议 10 字符以内）
• 提供清晰的使用说明和示例
• 保持"指令生成器"模式（不直接操作文件系统）

📄 许可证

MIT License

🔗 相关链接

• Model Context Protocol (MCP)
• GitHub Spec-Kit
• Conventional Commits
• OpenAPI Specification