探针套件

Name: 探针套件
Author: mybolide

作者：mybolide10 星标更新：2025-10-27

安装使用来源：spider==github.com

项目介绍

MCP Probe Kit

🚀 Cursor 开发增强工具集 - 让 AI 更好地理解您的开发过程

一个强大的 MCP（模型上下文协议）服务器，提供23种实用工具，覆盖整个代码质量、开发效率和项目管理的过程。

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

✨ 特性

🔍 代码质量 (7种工具)

detect_shell -AI模型套壳检测
code_review -代码审查助手
debug -智能调试助手
gentest -测试用例生成器
refactor -重构建议
perf -性能分析
fix -自动修复代码问题 🆕

🛠️ 开发效率 (11种工具)

gencommit -Git提交信息生成
genapi -API文档生成
gendoc -代码注释生成
genpr -PR描述生成
genchangelog -变更日志生成
gensql -SQL查询生成器 🆕
genui -UI组件生成器 (React+Vue) 🆕
explain -代码解释器 🆕
convert -代码转换器 🆕
genreadme -README生成器 🆕
split -文件分割工具 🆕

📦 项目管理 (5种工具)

init_setting -Cursor AI配置初始化
init_project -规范驱动项目初始化
check_deps -依赖健康检查
resolve_conflict -Git冲突解决助手 🆕
analyze_project -项目分析工具，帮助AI快速理解旧项目 🆕

🚀 快速开始

📦 方法1：直接使用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": {}
    }
  }
}

📦 方法2：全局安装

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

# 在Cursor中配置

配置内容：

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

📦 方法3：本地项目安装

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

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

配置内容：

{
  "mcpServers": {
    "mcp-probe-ki": {
      "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并重新打开（不要仅重新加载窗口）

📖 工具使用指南

🔍 代码质量工具

`detect_shell` -套壳检测

检测AI模型是否被表示/打包，并生成JSON指纹验证。

使用：detect_shell

`code_review` -代码审查

对代码质量、安全性、性能和最佳实践进行全面审查。

使用：code_review 或 code_review @file.ts

内容审查代码味道不好，安全漏洞，性能问题，命名约定

`debug` -调试助手

分析错误并生成调试策略和解决方案。

使用：debug 然后粘贴错误消息

输出错误分类，问题定位，调试步骤，解决方案，验证清单

`gentest` -测试生成

为代码生成完整的测试用例（支持Jest/Vitest/Mocha）。

使用：gentest @function.ts

生成内容单元测试，边界测试，异常测试，模拟数据

`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类型错误修复
代码格式化
导入语句优化
删除未使用的代码

🛠️ 开发效率工具

`gencommit` -提交生成

自动分析代码更改并生成标准化的Git提交信息（支持表情符号）。

使用：gencommit

格式：<type>: <emoji> <subject> (遵循常规提交)

类型：

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

包含更改总结，技术细节，测试说明，注意事项检查表

`genchangelog` -变更日志生成

基于提交历史生成CHANGELOG.md。

使用：genchangelog v1.2.0

格式保持变更日志标准

`gensql` -SQL生成器 🆕

根据自然语言描述生成SQL查询语句。

使用：gensql 然后描述需求（例如“查询购买金额超过平均值的用户”）

支持：PostgreSQL, MySQL, SQLite

功能：

复杂查询生成（JOIN, 子查询, 窗口函数）
表构建语句生成
索引优化建议
查询性能分析

`genui` -UI组件生成器 (React+Vue) 🆕

生成React或Vue 3 UI组件代码。

使用：genui 然后描述组件（例如“创建具有加载状态的Button组件”）

支持框架：

React：Hooks、forwardRef、TypeScript
Vue 3：组合API、script setup、TypeScript
HTML：原生JavaScript

功能：

完整组件实现（TypeScript）
Tailwind CSS/UnoCSS样式
可访问性（A11y）支持
Props/Emits类型定义
使用示例和最佳实践
推荐组件库（shadcn/ui, Element Plus等）

`explain` -代码解释器 🆕

详细解释代码逻辑和原理，以帮助理解复杂的代码。

使用：explain @complex-code.ts

解释内容：

整体功能概述
行行代码描述
核心原理分析
设计模式识别
时间/空间复杂度
使用场景和注意事项

适用场景：

理解遗留代码
学习新框架/库
复杂算法分析
代码审查

`convert` -代码转换器 🆕

转换代码格式或框架。

使用：convert @file.js 然后解释转换类型（例如“转换为TypeScript”）

支持转换：

JavaScript → TypeScript
类组件 → Hooks
Promises → Async/Await
CommonJS → ESM
CSS → Tailwind CSS
Vue 2 → Vue 3
JSON → TypeScript接口

`genreadme` -README生成器 🆕

根据项目代码自动生成README.md文档。

使用：genreadme 或提供项目信息

风格：标准，极简，详细

包含内容：

项目介绍和徽章
安装和快速开始
功能特性列表
使用示例
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, 语义检索

`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 然后粘贴冲突内容，或直接打开冲突文件

功能：

冲突原因分析
双方修改意图识别
推荐合并计划
完全解决的代码
冲突预防建议

适用场景：

合并功能分支
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

探针套件

项目介绍

MCP Probe Kit

✨ 特性

🔍 代码质量 (7种工具)

🛠️ 开发效率 (11种工具)

📦 项目管理 (5种工具)

🚀 快速开始

📦 方法1：直接使用NPX (推荐)

📦 方法2：全局安装

📦 方法3：本地项目安装

🔧 开发模式 (本地开发)

🔄 重启cursor

📖 工具使用指南

🔍 代码质量工具

detect_shell -套壳检测

code_review -代码审查

debug -调试助手

gentest -测试生成

refactor -重构建议

perf -性能分析

fix -自动修复 🆕

🛠️ 开发效率工具

gencommit -提交生成

genapi -文档生成

gendoc -注释生成

genpr -PR生成

genchangelog -变更日志生成

gensql -SQL生成器 🆕

genui -UI组件生成器 (React+Vue) 🆕

explain -代码解释器 🆕

convert -代码转换器 🆕

genreadme -README生成器 🆕

split -文件分割工具 🆕

📦 项目管理工具

init_setting -配置初始化

init_project -项目初始化

check_deps -依赖检查

resolve_conflict -Git冲突解决 🆕

analyze_project -项目分析工具 🆕

🎯 使用场景示例

📝 日常开发流程

🐛 调试过程

🚀 新项目启动

🔍 接管旧项目

📦 版本发布

🔍 性能优化

🛠️ 开发指南

项目结构

添加新工具

`detect_shell` -套壳检测

`code_review` -代码审查

`debug` -调试助手

`gentest` -测试生成

`refactor` -重构建议

`perf` -性能分析

`fix` -自动修复 🆕

`gencommit` -提交生成

`genapi` -文档生成

`gendoc` -注释生成

`genpr` -PR生成

`genchangelog` -变更日志生成

`gensql` -SQL生成器 🆕

`genui` -UI组件生成器 (React+Vue) 🆕

`explain` -代码解释器 🆕

`convert` -代码转换器 🆕

`genreadme` -README生成器 🆕

`split` -文件分割工具 🆕

`init_setting` -配置初始化

`init_project` -项目初始化

`check_deps` -依赖检查

`resolve_conflict` -Git冲突解决 🆕

`analyze_project` -项目分析工具 🆕