Devtools Debugger MCP

🚀 Node.js Debugger MCP

このMCPサーバーは、Chrome DevTools Protocolを使用して、包括的なNode.jsデバッグ機能を提供します。このサーバーにより、AIアシスタントはブレークポイント、ステップ実行、変数の検査、コールスタック、式の評価、ソースマップなどのすべての機能を利用して、Node.jsアプリケーションをデバッグすることができます。

🚀 クイックスタート

このMCPサーバーは、Node.jsアプリケーションのデバッグにAIの支援が必要な場合に便利です。Chrome DevToolsやVS Codeで利用できるすべてのデバッグ機能にプログラムからアクセスできるため、AIアシスタントがブレークポイントの設定、変数の検査、コードのステップ実行、実行時の動作分析などを支援することができます。

✨ 主な機能

• 完全なNode.jsデバッガー：ブレークポイント、条件付きブレークポイント、ログポイント、例外発生時の一時停止を設定できます。
• ステップ実行コントロール：ステップオーバー/イントゥ/アウト、指定位置まで続行、フレームの再開を行えます。
• 変数の検査：ローカル変数/クロージャスコープ、thisのプレビュー、オブジェクトのプロパティを詳細に調べることができます。
• 式の評価：現在のコールフレームでJavaScript式を評価し、コンソール出力をキャプチャできます。
• コールスタックの分析：コールスタックと一時停止状態の情報を検査できます。
• ソースマップのサポート：完全なソースマップサポートでTypeScriptやその他のトランスパイルされたコードをデバッグできます。
• コンソールの監視：デバッグセッション中のコンソール出力をキャプチャして確認できます。

📦 インストール

npm install devtools-debugger-mcp

📚 ドキュメント

設定

サーバーをMCP設定構成に追加します。

{
  "devtools-debugger-mcp": {
    "command": "node",
    "args": ["path/to/devtools-debugger-mcp/dist/index.js"]
  }
}

または、グローバルにインストールした場合は、CLIバイナリを使用できます。

{
  "devtools-debugger-mcp": {
    "command": "devtools-debugger-mcp"
  }
}

Node.jsのデバッグ

このMCPサーバーは、組み込みのインスペクター (--inspect-brk=0) を使用してNode.jsプログラムを起動し、Chrome DevTools Protocol (CDP) を使用してデバッグできます。

動作原理

• start_node_debug は node --inspect-brk=0 your-script.js を起動し、インスペクターのWebSocketを待機して接続し、最初の一時停止 (最初の行) を pauseId とトップコールフレームとともに返します。
• その後、ブレークポイントを設定し (ファイルパスまたはURL正規表現で)、例外発生時の一時停止を選択し、再開/ステップ実行を行うことができます。各一時停止で、ツールはスコープを検査し、式を評価し、前回のステップ/再開以降にキャプチャされたコンソール出力を読み取ることができます。
• プロセスが終了すると、サーバーはCDPセッションをクリーンアップし、状態をリセットします。

クイックスタート (MCP対応クライアントから)

1. デバッグセッションを開始します。

{ "tool": "start_node_debug", "params": { "scriptPath": "/absolute/path/to/app.js" } }

2. ブレークポイントを設定します (ファイルパス + 1から始まる行番号)。

{ "tool": "set_breakpoint", "params": { "filePath": "/absolute/path/to/app.js", "line": 42 } }

3. 次の一時停止まで実行します (必要に応じてコンソール/スタックを含める)。

{ "tool": "resume_execution", "params": { "includeConsole": true, "includeStack": true } }

4. 一時停止時に検査します。

{ "tool": "inspect_scopes", "params": { "maxProps": 15 } }
{ "tool": "evaluate_expression", "params": { "expr": "user.name" } }

5. ステップ実行します。

{ "tool": "step_over" }
{ "tool": "step_into" }
{ "tool": "step_out" }

6. 終了します。

{ "tool": "stop_debug_session" }

Node.jsツールリファレンス (概要)

• start_node_debug({ scriptPath, format? }) — インスペクター付きでNodeを起動し、最初の一時停止を返します。
• set_breakpoint({ filePath, line }) — ファイルパスでブレークポイントを設定します (1から始まる行番号)。
• set_breakpoint_condition({ filePath?, urlRegex?, line, column?, condition, format? }) — 条件付きブレークポイントまたはURL正規表現で設定します。
• add_logpoint({ filePath?, urlRegex?, line, column?, message, format? }) — ログを出力して false を返す条件付きブレークポイントを介したログポイントを追加します。
• set_exception_breakpoints({ state }) — none | uncaught | all。
• blackbox_scripts({ patterns }) — 一致するスクリプトURLのフレームを無視します。
• list_scripts() / get_script_source({ scriptId? | url? }) — スクリプトソースを探索して取得します。
• continue_to_location({ filePath, line, column? }) — 特定のソース位置まで実行します。
• restart_frame({ frameIndex, pauseId?, format? }) — 選択したフレームを再実行します。
• resume_execution({ includeScopes?, includeStack?, includeConsole?, format? }) — 次の一時停止または終了まで続行します。
• step_over|step_into|step_out({ includeScopes?, includeStack?, includeConsole?, format? }) — 結果にオプションのコンテキストを含めたステップ実行を行います。
• evaluate_expression({ expr, pauseId?, frameIndex?, returnByValue?, format? }) — 一時停止したフレームで式を評価します；デフォルトはトップフレームです。
• inspect_scopes({ maxProps?, pauseId?, frameIndex?, includeThisPreview?, format? }) — ローカル変数/クロージャと this の概要を表示します。
• get_object_properties({ objectId, maxProps?, format? }) — オブジェクトのプレビューを詳細に調べます。
• list_call_stack({ depth?, pauseId?, includeThis?, format? }) — トップNフレームの概要を表示します。
• get_pause_info({ pauseId?, format? }) — 一時停止の理由/位置の概要を取得します。
• read_console({ format? }) — 前回のステップ/再開以降のコンソールメッセージを読み取ります。
• stop_debug_session() — プロセスを終了し、接続を切断します。

注意事項

• ファイルパスは、CDP互換性のために内部で file:// URLに変換されます。
• line は1から始まります；CDPは内部では0から始まります。
• サーバーは一時停止間のコンソール出力をバッファリングします；ステップ/再開時の includeConsole または read_console で取得できます。
• set_output_format({ format: 'text' | 'json' | 'both' }) を使用して、デフォルトのレスポンス形式を設定します。

利用可能なツール

このMCPサーバーは、次のNode.jsデバッグツールを提供します。すべてのツールは、オプションの format パラメータ ('text' または 'json') をサポートしており、レスポンスの形式を制御できます。

セッション管理

• start_node_debug - デバッグを有効にしてNode.jsスクリプトを起動します。
• stop_debug_session - デバッグセッションを終了し、クリーンアップします。

ブレークポイント管理

• set_breakpoint - 特定のファイルと行にブレークポイントを設定します。
• set_breakpoint_condition - 条件付きブレークポイントまたはURL正規表現でブレークポイントを設定します。
• add_logpoint - ヒットしたときにメッセージをログに記録するログポイントを追加します。
• set_exception_breakpoints - 例外発生時の一時停止動作を構成します。

実行制御

• resume_execution - 次のブレークポイントまたは完了まで実行を続けます。
• step_over - 現在の行をステップオーバーします。
• step_into - 関数呼び出しにステップイントゥします。
• step_out - 現在の関数からステップアウトします。
• continue_to_location - 特定の位置に到達するまで実行します。
• restart_frame - 特定のコールフレームから実行を再開します。

検査と分析

• inspect_scopes - ローカル変数、クロージャ、および this コンテキストを調べます。
• evaluate_expression - 現在のコンテキストでJavaScript式を評価します。
• get_object_properties - オブジェクトのプロパティを詳細に調べます。
• list_call_stack - 現在のコールスタックを表示します。
• get_pause_info - 現在の一時停止状態に関する情報を取得します。

ユーティリティ

• list_scripts - すべての読み込まれたスクリプトを一覧表示します。
• get_script_source - スクリプトのソースコードを取得します。
• blackbox_scripts - デバッグ中にスキップするスクリプトを構成します。
• read_console - デバッグ中にキャプチャされたコンソール出力を読み取ります。

詳細な使用例とパラメータの説明については、上記の「Node.jsのデバッグ」セクションを参照してください。

📄 ライセンス

MIT