Node Debugger

Node.js デバッガー MCP サーバー

AI エージェント向けに、プロセス管理を備えた Node.js デバッグ機能を提供する MCP サーバーです。

機能

• プロセス管理：デバッグを有効にして Node.js プロセスを開始／停止します
• デバッグツール：ブレークポイントを設定し、コードをステップ実行し、式を評価します
• インスペクター連携：Node.js Inspector API に接続します
• AI エージェントに最適：長時間のデバッグセッション向けに設計されています

インストール

1. サーバーをビルドします：

   npm install
   npm run build
   

2. プロジェクト固有で使用する場合：このプロジェクトでは .mcp.json ファイルがすでに設定されています

3. ユーザー全体で使用する場合：グローバルの Claude Code 設定に追加します：

   claude mcp add --scope user debugger-mcp node /absolute/path/to/debugger-mcp/build/index.js
   

4. グローバルに使用する場合：.mcp.json を各プロジェクトにコピーするか、グローバル設定に追加します

Claude Code での使用方法

設定が完了すると、Claude Code で次のツールを利用できます：

プロセス管理

• start_node_process - デバッグを有効にして Node.js スクリプトを起動します
• kill_process - PID を指定してプロセスを終了します
• list_processes - 管理対象の全プロセスを表示します

デバッグ

• attach_debugger - デバッグポートに接続します
• set_breakpoint - 条件を任意で指定してブレークポイントを設定します
  • 重要：ブレークポイントを確実にヒットさせるには、完全な file:// URL を使用してください
  • 例：file:///Users/you/project/script.js
• step_debug - コードをステップ実行します（next/step/continue/out）
• pause_execution - 実行中のプロセスを手動で一時停止します
• evaluate_expression - デバッグコンテキストで式を評価します

リソース

• debug://session - 現在のデバッグセッションの状態
• debug://processes - 管理対象プロセスの一覧

使用例

1. Node.js プロセスを開始します：

   Use the start_node_process tool with script: "example-app.js"
   

2. デバッガーをアタッチします：

   Use attach_debugger tool with the port returned from step 1
   

3. ブレークポイントを設定してデバッグします：

   # Set a breakpoint using full file URL
   Use set_breakpoint tool with:
   - file: "file:///absolute/path/to/example-app.js"
   - line: 5
   
   # Control execution
   Use step_debug tool with action: "continue"
   

主な機能

• 起動時の自動一時停止：--inspect-brk フラグを使用して、最初の行で一時停止します
• Chrome DevTools Protocol の完全サポート：シミュレーションではなく、実際にデバッグできます
• 確実なブレークポイント：ブレークポイントを安定してヒットさせるには、file:// URL を使用します
• プロセス管理：複数のデバッグセッションを追跡および管理します

テスト

付属のサンプルアプリでテストします：

node --inspect=9229 example-app.js

その後、MCP ツールを使ってデバッグしてください！

MCP サーバーのデバッグ

npm run inspector