Gdb MCP

🚀 GDB MCP Server (FastMCP)

このプロジェクトは、GDB内で動作する軽量なMCPサーバーです。gdb-commandというツールを提供し、入力を直接GDBのコマンドインタープリタに転送し、テキスト出力を返します。サーバーはSSEを介して動作し、mcp-serverコマンドでGDB内から起動できます。

🚀 クイックスタート

1. MCP拡張を読み込んでGDBを起動する

• gdb -q -ex 'source ./gdb-mcp'
• または、GDB内でsource ./gdb-mcpを実行する

2. GDB内からSSEサーバーを起動する

• mcp-server 127.0.0.1 3333

3. MCPクライアントをサーバーに接続する

• MCPクライアントを設定して、上記で選択したホストとポートのSSEサーバーに接続し、gdb-commandツールを呼び出します。

ツール: gdb-command

• パラメータ:
  • command (文字列): 実行する正確なGDBコマンド（例: info registers）。
• 戻り値: 文字列（取得したGDBの出力またはエラーメッセージ）。

✨ 主な機能

• gdb-command: 任意のGDBコマンドを渡し、その出力を取得します。
• 最小限で自己完結型のスクリプト: gdb-mcp（sourceを介して読み込まれます）。

📦 インストール

必要条件

• Pythonサポートが有効になっているGDB。
• Python 3.xと、GDBの組み込みPythonで利用可能なfastmcpライブラリ。

Pythonサポートを確認する: gdb -q -ex "python print('ok')" -ex quit

FastMCPをインストールする: python3 -m pip install fastmcp GDB内でインポートに失敗した場合は、fastmcpがGDBが使用するPython環境にインストールされていることを確認してください。

🔧 技術詳細

注意事項とヒント

⚠️ 重要提示

このスクリプトにはタイムアウトや停止制御は提供されていません。長時間実行されるターゲットの実行を中断するには、interruptコマンドを発行してください。クライアントを信頼できる場合以外は、公開バインドを行わないでください。このエンドポイントは任意のGDBコマンドを実行できます。

💡 使用建议

自動読み込みするには、~/.gdbinitに次の行を追加してください: source /absolute/path/to/gdb-mcp。組み込みの「サーバー停止」機能はありません。サーバーを停止するには、GDBを終了してください。

📄 ライセンス

MITライセンス — LICENSEを参照してください。

謝辞

このプロジェクトは、優れたfastmcpライブラリをベースに構築されています。