Gdb MCP Server

🚀 GDB デバッグサーバー

GDB デバッグサーバーは、AI 支援デバッグをサポートするツールです。AI エージェントやその他のツールが MCP プロトコルを通じて GDB とやり取りできるようにします。このプロジェクトは GitHub 上にあり、現在も開発中です。コミュニティからのフィードバックを歓迎します。

✨ 主な機能

1. 既存の GDB プロセスの検出とアタッチ：実行中の GDB インスタンスを自動的に識別し、アタッチできます。
2. ターミナルウィンドウ通信（macOS では iTerm2 最適化サポート）：macOS で GDB ターミナルウィンドウとやり取りし、最高のサポートを提供します。
3. MCP プロトコルの統合：MCP プロトコルを通じてツール間の通信と統合を実現します。
4. コマンドブロッキングのスマートな処理：ブロッキングコマンド（例：target remote）を自動的に検出して処理し、中断信号を送信してデッドロックを回避します。
5. 多アーキテクチャとリモートデバッグのサポート：複数のプロセッサアーキテクチャをサポートし、リモートデバッグターゲットへの接続機能を提供します。
6. 関数呼び出しによる一般的なデバッグ操作の実行：一連のツール関数を通じて、ブレークポイントの設定、メモリのチェック、逆アセンブルなどの一般的なデバッグタスクを実行します。

🎥 デモビデオ

このプロジェクトには、GDB デバッグサーバーを使用したデバッグ方法を示すデモビデオが用意されています。ビデオのリンクは以下の通りです。

デモビデオ

📦 インストール

ダウンロードとインストール

1. リポジトリをクローンします：

   git clone https://github.com/your-username/gdb-mcp-server.git
   cd gdb-mcp-server
   

2. 依存関係をインストールします：

   pip install -r requirements.txt
   

サーバーの起動

GDB デバッグサーバーを起動します：

python server.py

💻 使用例

ツール関数

システムツール

• sys_find_gdb_processes：実行中のすべての GDB プロセスを検索します。
• sys_attach_to_gdb：指定された GDB プロセスにアタッチします。
• sys_start_gdb_with_remote：GDB を起動し、リモートデバッグターゲットに接続します。

GDB デバッグツール

• gdb_execute_command：任意の GDB コマンドを実行します。
• gdb_set_breakpoint：ブレークポイントを設定します。
• gdb_delete_breakpoint：ブレークポイントを削除します。
• gdb_step：命令を 1 ステップ実行します。
• gdb_next：次の行まで実行します。
• gdb_finish：関数が返るまで実行します。
• gdb_continue：プログラムの実行を続けます。
• gdb_get_registers：レジスタの値を取得します。
• gdb_examine_memory：メモリの内容をチェックします。
• gdb_get_stack：スタックトレース情報を取得します。
• gdb_get_locals：ローカル変数の情報を取得します。
• gdb_disassemble：指定されたコードセグメントを逆アセンブルします。
• gdb_connect_remote：リモートデバッグターゲットに接続します。

📚 ドキュメント

macOS のベストプラクティス

1. 最適なサポートを得るために、ターミナルエミュレータとして iTerm2 を使用します。
2. サーバーを起動する前に、GDB ターミナルウィンドウが開いていて、フォアグラウンドにあることを確認します。
3. リモートデバッグの場合は、まず手動で GDB の設定を行い、その後サーバーを介してターゲットにアタッチします。

よくある問題

macOS での問題

1. ウィンドウのアクティブ化問題：GDB ウィンドウが正しくアクティブ化されない場合は、手動でフォアグラウンドに移動させます。
2. 入力メソッドの状態：GDB ターミナルが中国語やその他の入力メソッドの状態になっていないことを確認し、コマンドの実行に影響を与えないようにします。
3. コマンドのブロッキング：ブロッキングコマンド（例：target remote）の場合は、サーバーが自動的に中断信号を送信して処理します。

Linux での問題

1. TTY 権限の問題：現在のユーザーが GDB プロセスの TTY デバイスにアクセスする権限を持っていることを確認します。
2. pexpect 依存関係：GDB との対話型通信に使用される pexpect ライブラリがインストールされていることを確認します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細な条項については、LICENSE ファイルを参照してください。