MCP Probe Kit

🚀 Cursor 开发增强工具集 - 让 AI 更懂你的开发流程

一个强大的 MCP (Model Context Protocol) 服务器，提供 23 个实用工具，覆盖代码质量、开发效率、项目管理全流程。

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

✨ 功能特性

🔍 代码质量（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 直接使用（推荐）

无需安装，直接使用：

Windows 配置路径：

macOS/Linux 配置路径：

配置内容：

📦 方式二：全局安装

配置内容：

📦 方式三：本地项目安装

配置内容：

🔧 开发模式（本地开发）

如果你在本地开发或修改工具：

Windows:

macOS/Linux:

配置内容：

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

🔄 重启 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

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. 创建工具文件：src/tools/your_tool.ts

2. 导出工具：在 src/tools/index.ts 中添加

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

4. 重新构建：

开发命令

🔧 配置说明

MCP 服务器配置

配置文件位置（根据你的 MCP 客户端）：

• Cursor: cline_mcp_settings.json

• Claude Desktop: claude_desktop_config.json

工具参数说明

所有工具的参数都是可选的，AI 会自动推断。常用参数：

🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

改进建议：

• 新增实用工具

• 优化现有工具的提示词

• 改进文档和示例

• 修复 Bug

开发规范：

• 遵循 TypeScript 规范

• 工具命名简洁（建议 10 字符以内）

• 提供清晰的使用说明和示例

• 保持"指令生成器"模式（不直接操作文件系统）

📄 License

MIT License

🔗 相关链接

• Model Context Protocol (MCP)

• GitHub Spec-Kit

• Conventional Commits

• OpenAPI Specification

💡 设计理念

指令生成器模式

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

• 工具不直接操作文件系统或执行命令

• 而是生成清晰的指令告诉 AI 需要做什么

• AI 理解指令后，使用 Cursor 的能力完成实际操作

优势：

• ✅ 代码简洁，易于维护

• ✅ AI 可以智能处理边界情况

• ✅ 用户可见操作过程，更透明

• ✅ 灵活性强，AI 可以根据实际情况调整

为什么叫 Probe Kit？

• Probe（探针）：探测代码质量、性能瓶颈、依赖健康度

• Kit（工具集）：23 个工具覆盖开发全流程

工具分类

👨‍💻 作者

小墨 (Kyle)

• 🌐 Website: bytezonex.com

• 💼 专注于 AI 辅助开发工具

Made with ❤️ for Cursor Users