MCP Server GDB

MCP Server GDB

MCP プロトコルに基づく GDB/MI プロトコルサーバーで、AI アシスタントにリモートアプリケーションのデバッグ機能を提供します。

特徴

• GDB デバッグセッションの作成と管理
• ブレークポイントの設定と管理
• スタック情報と変数の表示
• プログラム実行の制御（実行、一時停止、ステップ実行など）
• 複数セッションでの並行デバッグに対応
• エージェントの動作を調べてプロンプトを改善できる、組み込みの TUI（開発中）

インストール

ビルド済みバイナリ

リリースページからお使いのプラットフォームに合ったバイナリを選び、直接実行できます。

ソースからビルド

リポジトリをクローンし、cargo でビルドします

cargo build --release
cargo run

Nix を使用

Nix がインストールされている場合、クローンせずにプロジェクトを実行できます。

ローカルで実行（クローン後）

nix run .

GitHub からリモート実行

nix run "git+https://github.com/pansila/mcp_server_gdb.git" -- --help

開発環境

すべての依存関係がそろった開発用シェルに入るには、次を実行します。

nix develop

使用方法

1. そのまま実行します：./mcp-server-gdb
2. サーバーは次の 2 つのトランスポートモードに対応しています。
   • Stdio（デフォルト）：標準入出力トランスポート
   • SSE：Server-Sent Events トランスポート。デフォルトは http://127.0.0.1:8080 です

設定

src/config.rs ファイルまたは環境変数を変更して、サーバーの設定を調整できます。

• サーバーの IP アドレス
• サーバーのポート
• GDB コマンドのタイムアウト時間（秒）

対応する MCP ツール

セッション管理

• create_session - 新しい GDB デバッグセッションを作成します
• get_session - 指定したセッションの情報を取得します
• get_all_sessions - すべてのセッションを取得します
• close_session - セッションを終了します

デバッグ制御

• start_debugging - デバッグを開始します
• stop_debugging - デバッグを停止します
• continue_execution - 実行を再開します
• step_execution - 次の行にステップインします
• next_execution - 次の行をステップオーバーします

ブレークポイント管理

• get_breakpoints - ブレークポイントの一覧を取得します
• set_breakpoint - ブレークポイントを設定します
• delete_breakpoint - ブレークポイントを削除します

デバッグ情報

• get_stack_frames - スタックフレーム情報を取得します
• get_local_variables - ローカル変数を取得します
• get_registers - レジスタを取得します
• read_memory - メモリの内容を読み取ります

ライセンス

MIT