MCP Probe Kit

🚀 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が既存プロジェクトを迅速に理解するのを支援 🆕

---

🚀 クイックスタート

📦 方法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-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を完全に終了してから再度開きます（ウィンドウを再読み込みするのではなく）。

---

📖 ツール使用ガイド

🔍 コード品質ツール

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コミットメッセージを生成します（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

含まれる内容：変更の概要、技術的な詳細、テストの説明、注意事項、チェックリスト

---

genchangelog - Changelog生成

コミット履歴に基づいて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

説明内容：

• 全体的な機能の概要
• コードの逐行説明
• 核心原理の分析
• 設計パターンの識別
• 時間/空間の複雑さ
• 使用シーンと注意事項

適用シーン：

• 既存コードの理解
• 新しいフレームワーク/ライブラリの学習
• 複雑なアルゴリズムの分析
• コードレビュー

---

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ストア）

適用シーン：

• 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

---

🤝 貢献ガイド

IssueとPull Requestの提出を歓迎します！

改善提案：

• 新しい便利なツールを追加する
• 既存のツールのプロンプトを最適化する
• ドキュメントと例を改善する
• Bugを修正する

開発規則：

• TypeScriptの規則に従う
• ツールの名前は簡潔にする（10文字以内を推奨）
• 明確な使用説明と例を提供する
• "指令生成器"モードを維持する（ファイルシステムを直接操作しない）

---

📄 ライセンス

MITライセンス

---

🔗 関連リンク

• Model Context Protocol (MCP)
• GitHub Spec-Kit
• Conventional Commits
• OpenAPI 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)

• 🌐 ウェブサイト: bytezonex.com
• 💼 AI支援開発ツールに特化しています。

---

Made with ❤️ for Cursor Users