MCP Dap Server

🚀 MCP DAP Server

このサーバーは、Debug Adapter Protocol (DAP) を通じてデバッグ機能を提供するModel Context Protocol (MCP) サーバーです。AIアシスタントやその他のMCPクライアントが、様々なプログラミング言語のデバッガーと対話できるようになります。

🚀 クイックスタート

MCP DAP Serverは、MCPクライアントとDAP互換のデバッガーの間の橋渡し役を果たし、プログラムによるデバッグセッションの制御を可能にします。以下のような包括的なデバッグツールを提供します。

• デバッグセッションの開始と停止
• ブレークポイントの設定（行ベースと関数ベース）
• プログラムの実行制御（続行、ステップイン/アウト/オーバー、一時停止）
• プログラムの状態の検査（スレッド、スタックトレース、変数、スコープ）
• 式の評価
• 実行中のプロセスへのアタッチ
• 例外のハンドリング

✨ 主な機能

基本的なデバッグ操作

• セッション管理：デバッグセッションの開始、停止、再開、終了
• ブレークポイント管理：行と関数のブレークポイントの設定
• 実行制御：続行、一時停止、ステップ操作（イン/アウト/次）
• 状態検査：スレッド、スタックトレース、スコープ、変数の表示
• 式の評価：現在のデバッグコンテキストで式を評価
• 変数の変更：デバッグ中に変数の値を変更

高度な機能

• プロセスのアタッチ：既に実行中のプロセスにアタッチ
• モジュール情報：読み込まれたモジュールの一覧表示
• ソース情報：読み込まれたソースファイルの表示
• 逆アセンブル：逆アセンブルされたコードの表示
• 例外ハンドリング：例外に関する情報の取得

📦 インストール

前提条件

• Go 1.24.4 以上
• 対象言語のDAP互換デバッガー

ソースからのビルド

git clone https://github.com/go-delve/mcp-dap-server
cd mcp-dap-server
go build -o bin/mcp-dap-server

💻 使用例

サーバーの起動

サーバーはデフォルトでポート8080をリッスンします。

./bin/mcp-dap-server

MCP経由での接続

MCPクライアントを設定して、SSE (Server-Sent Events) トランスポートを使用して http://localhost:8080 のサーバーに接続します。

MCPクライアントの設定例

この設定は、(Gemini CLI)[https://developers.google.com/gemini-code-assist/docs/use-agentic-chat-pair-programmer#configure-mcp-servers] などのエージェントで動作するはずです（または出発点として機能します）。

{
  "mcpServers": {
    "dap-debugger": {
      "command": "mcp-dap-server",
      "args": [],
      "env": {}
    }
  }
}

Claude Codeを使用した設定例

Claude Code

claude mcp add --transport sse mcp-dap-server http://localhost:8080

利用可能なツール

セッション管理

start_debugger

新しいデバッグセッションを開始します。

• パラメーター：
  • port (数値): DAPサーバーのポート番号

stop_debugger

現在のデバッグセッションを停止します。

restart_debugger

現在のデバッグセッションを再開します。

terminate_debugger

デバッガーとデバッグ対象のプロセスを終了します。

プログラム制御

debug_program

デバッグモードでプログラムを起動します。

• パラメーター：
  • path (文字列): デバッグするプログラムのパス

exec_program

デバッグせずにプログラムを実行します。

• パラメーター：
  • path (文字列): 実行するプログラムのパス

attach_debugger

実行中のプロセスにアタッチします。

• パラメーター：
  • mode (文字列): アタッチモード
  • processId (数値, オプション): アタッチするプロセスID

ブレークポイント

set_breakpoints

ファイル内に行ブレークポイントを設定します。

• パラメーター：
  • file (文字列): ソースファイルのパス
  • lines (配列): ブレークポイントの行番号

set_function_breakpoints

関数ブレークポイントを設定します。

• パラメーター：
  • functions (配列): 関数名

実行制御

continue

プログラムの実行を続行します。

• パラメーター：
  • threadId (数値, オプション): 続行するスレッドID

next

現在の行をステップオーバーします。

• パラメーター：
  • threadId (数値): スレッドID

step_in

関数呼び出しにステップインします。

• パラメーター：
  • threadId (数値): スレッドID

step_out

現在の関数からステップアウトします。

• パラメーター：
  • threadId (数値): スレッドID

pause

プログラムの実行を一時停止します。

• パラメーター：
  • threadId (数値): スレッドID

状態検査

threads

デバッグ対象のプロセス内のすべてのスレッドを一覧表示します。

stack_trace

スレッドのスタックトレースを取得します。

• パラメーター：
  • threadId (数値): スレッドID
  • startFrame (数値, オプション): 開始フレームのインデックス
  • levels (数値, オプション): 取得するフレームの数

scopes

スタックフレームの変数スコープを取得し、各スコープ内のすべての変数を自動的に取得します。

• パラメーター：
  • frameId (数値): スタックフレームID
• 戻り値：次のような形式で表示されます。
  • 利用可能なすべてのスコープ（ローカル変数、引数、グローバル変数など）
  • 各スコープ内の変数の名前、型、値
  • さらに検査できる複合型の変数参照

variables

スコープ内の変数を取得します。

• パラメーター：
  • variablesReference (数値): 変数参照

evaluate

式を評価します。

• パラメーター：
  • expression (文字列): 評価する式
  • frameId (数値, オプション): フレームコンテキスト
  • context (文字列, オプション): 評価コンテキスト

set_variable

変数の値を設定します。

• パラメーター：
  • variablesReference (数値): 変数参照
  • name (文字列): 変数名
  • value (文字列): 新しい値

追加ツール

loaded_sources

すべての読み込まれたソースファイルを一覧表示します。

modules

読み込まれたモジュールを一覧表示します。

disassemble

メモリ位置のコードを逆アセンブルします。

• パラメーター：
  • memoryReference (文字列): メモリアドレス
  • instructionOffset (数値, オプション): 命令オフセット
  • instructionCount (数値): 命令の数

exception_info

例外情報を取得します。

• パラメーター：
  • threadId (数値): スレッドID

disconnect

デバッガーから切断します。

• パラメーター：
  • terminateDebuggee (ブール値, オプション): デバッグ対象を終了するかどうか

configuration_done

設定が完了したことを通知します。

📚 ドキュメント

デモ

• 複数のプロンプトを使用した基本的なデモ
• 自律的なエージェントデバッグ パート1
• 自律的なエージェントデバッグ パート2

🔧 技術詳細

• Model Context Protocol SDK for Go を使用して構築されています。
• Google DAP implementation for Go を使用しています。

📄 ライセンス

MIT

謝辞

このプロジェクトは、以下のライブラリを使用しています。

• Model Context Protocol SDK for Go
• Google DAP implementation for Go

コントリビューションは大歓迎です！プルリクエストを送信してください。