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 會自動推斷。常用參數：

❓ 常見問題

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