claude-debugs-for-you MCP — ユースケース, インストール & ライブデモ

なぜ使うのか

主な機能

言語非依存 — VS Codeがサポートするすべてのデバッガーに対応
ツール: ブレークポイントの設定/削除、続行、ステップ実行、式の評価、スタック一覧表示
VS Code拡張機能からMCPクライアントへのstdioまたはSSEトランスポート
Claude Desktop、Continue、Cursorと連携可能
有効な.vscode/launch.jsonが必要

ライブデモ

実際の動作

claude-debugs-for-you.replay ▶ 準備完了

0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "claude-debugs-for-you": {
      "command": "npx",
      "args": [
        "-y",
        "claude-debugs-for-you"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "claude-debugs-for-you": {
      "command": "npx",
      "args": [
        "-y",
        "claude-debugs-for-you"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "claude-debugs-for-you": {
      "command": "npx",
      "args": [
        "-y",
        "claude-debugs-for-you"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "claude-debugs-for-you": {
      "command": "npx",
      "args": [
        "-y",
        "claude-debugs-for-you"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "claude-debugs-for-you",
      "command": "npx",
      "args": [
        "-y",
        "claude-debugs-for-you"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json

{
  "context_servers": {
    "claude-debugs-for-you": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "claude-debugs-for-you"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add claude-debugs-for-you -- npx -y claude-debugs-for-you

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方： claude-debugs-for-you

Claudeにデバッガーを操作させてバグを絞り込む

👤 原因不明のバグに行き詰まっている開発者 ⏱ ~20 min intermediate

使うタイミング： ログを20分読み続けている状態。Claudeに戦略的なブレークポイントを設定させ、変数の状態を確認させましょう。

前提条件

実行可能なコンフィグを含む.vscode/launch.json — 最初のコンフィグに${file}を使用すると、開いているファイルをClaudeが実行できます
claude-debugs-for-you拡張機能のインストール — VS Code Marketplace

フロー

拡張機能サーバーを起動する

Start the debug MCP server. Note the path it prints and paste into Claude Desktop config.✓ コピーしました

→ 拡張機能のステータスバーに実行中と表示される
バグの内容を説明する

My function computeTotal() returns NaN when cart has sale items. Place a breakpoint at the start, step through, and tell me where it goes wrong.✓ コピーしました

→ ブレークポイントが設定され、プログラムがそこまで実行され、Claudeがローカル変数を調査する
診断する

Based on the values at each step, what's the root cause and what's the smallest fix?✓ コピーしました

→ 根本原因と修正パッチ

結果： Claudeがデバッガーを操作してバグを発見 — printデバッグより高速です。

注意点

launch.jsonの設定が間違っていてデバッガーが起動できない — まずVS CodeでF5を押して動作確認してから、Claudeに操作させてください
Claudeがブレークポイントを設定しすぎて動作が極端に遅くなる — 可能な限り条件付きブレークポイントを使うよう指示してください

組み合わせ： git-2

式の評価で複雑なランタイム状態を理解する

👤 不慣れなコードをリバースエンジニアリングしている開発者 ⏱ ~15 min intermediate

使うタイミング： コードは動くが理由がわからない場合。重要な行にブレークポイントを設定し、Claudeに状態を調べさせましょう。

フロー

一時停止する

Set a breakpoint at line X, run the test, and when paused tell me what's in scope.✓ コピーしました

→ スコープのダンプ
式を評価する

Evaluate this.store.getState().users.filter(u => u.active).length. Then show me this.config.✓ コピーしました

→ 評価結果

結果： テストコードを書かずにライブ探索が可能です。

注意点

副作用のある式の評価が状態を変更してしまう — 意図的に変更する場合を除き、読み取り専用の式に限定してください

組み合わせ

他のMCPと組み合わせて10倍の力を

claude-debugs-for-you + git-2

デバッグ → 修正 → コミットのループ

Debug the failing test, apply the fix you propose, then commit with a message describing what was wrong.✓ コピーしました

ツール

このMCPが提供する機能

ツール	入力	呼び出すタイミング	コスト
set_breakpoint	file, line, condition?	デバッグセッションの開始前/実行中	free
remove_breakpoint	id	セッション間のクリーンアップ	free
continue		実行を再開し、次の一時停止情報を返す	free
step_over		関数内に入らずに1ステップ実行	free
evaluate	expression: str	現在の一時停止地点で値を調査	free
get_stack		コールチェーンを確認	free

コストと制限

運用コスト

APIクォータ: なし
呼び出しあたりのトークン: 1回あたりは少量。セッション全体では、状態を多く探索すると10〜50kトークンになる場合があります
金額: 無料、MIT
ヒント: まずClaudeに仮説を立てさせ、的を絞ったブレークポイントで検証させましょう — 無目的なステップ実行を避けられます。

セキュリティ

権限、シークレット、影響範囲

認証情報の保管： なし

データ送信先： ローカルデバッガー。値はご利用のLLMプロバイダーに送信されます

絶対に付与しない： Arbitrary `evaluate` on production databases via a debugger session

式の内容によっては評価に副作用が生じる可能性があります — eval()と同等の注意を払ってください。
本番プロセスに対して実行しないでください。再現可能なローカル環境を使用してください。

トラブルシューティング

よくあるエラーと対処法

Extension doesn't start / ステータスバーに'running'が表示されない

VS Codeの開発者ツールコンソールを開いてください。多くの場合ポート競合が原因です — 拡張機能の設定でポートを変更してください。

Debugger fails to start

まずF5で手動テストしてください。launch.jsonの最初のコンフィグが${file}を使用していることを確認してください。

Claudeが'no active debug session'と表示する

実行中のプログラムが必要です。Claudeにデバッグ開始を依頼すると、VS Codeのデフォルトコンフィグが起動します。

代替案

claude-debugs-for-you 他との比較

代替案	代わりに使う場面	トレードオフ
VS Code + Copilot chat with debug context	すでにCopilotを契約しておりVS Codeをネイティブに使用している場合	スクリプタビリティが低い。Copilotのモデルに依存

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る