Multi-Debugger MCP Server (LLDB and GDB)

GDB と LLDB の両デバッガーにデバッグ機能を提供する Model Context Protocol サーバーで、Claude Desktop、VSCode Copilot、その他の AI アシスタントで使用できます。

クイックスタート

uv sync
uv venv
uv run server.py

Related MCP server: LLDB MCP Server

統合

uv run を使用して server.py スクリプトを実行するか、uv venv を使用して仮想環境を作成し、/home/youruser/dev/personal/GDB-MCP/.venv/bin/python /home/youruser/dev/personal/GDB-MCP/server.py を実行できます。

Claude Desktop

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "gdb": {
      "command": "uv",
      "args": ["run", "/home/youruser/dev/personal/GDB-MCP/server.py"],
      "disabled": false
    }
  }
}

VSCode Copilot

WSL を使用している場合：

 "mcp": {
    "servers": {
      "my-mcp-server-4dc36648": {
        "type": "stdio",
        "command": "wsl",
        "args": [
          "/home/youruser/dev/personal/GDB-MCP/.venv/bin/python",
          "/home/youruser/dev/personal/GDB-MCP/server.py"
        ]
      }
    }
  }

WSL を使用していない場合：

  "mcp": {
    "servers": {
      "my-mcp-server-db89eee1": {
        "type": "stdio",
        "command": "/home/youruser/dev/personal/GDB-MCP/.venv/bin/python",
        "args": ["/home/youruser/dev/personal/GDB-MCP/server.py"]
      }
    }
  }

Windsurf

{
  "mcpServers": {
    "debugger-mcp": {
      "command": "python3",
      "args": ["/Users/youruser/dev/GDB-MCP/server.py"]
    }
  }
}

実験的 LLDB サポート (macOS)

このプロジェクトには、GDB に加えて実験的なネイティブ LLDB サポートが含まれており、デバッガーが自動選択されます。

インストール

macOS で LLDB サポートを有効にするには、Homebrew 経由で LLVM (LLDB を含む) と python をインストールします：

# Install LLDB for supporting python3.14 bindings
brew install llvm python3

# Install MCP and debugging dependencies
pip3 install mcp pygdbmi --break-system-packages

利用可能なツール

統合ツール

• debugger_status(): 利用可能なデバッガーとそのステータスを表示します

• debugger_start(): 自動検出されたデバッガーでデバッグセッションを開始します

• debugger_terminate(session_id): デバッグセッションを終了します

• debugger_list_sessions(): アクティブなデバッグセッションをすべて一覧表示します

• debugger_command(session_id, command): デバッガーコマンドを実行します

LLDB ツール

• lldb_start(): 新しい LLDB デバッグセッションを開始します

• lldb_terminate(session_id): LLDB デバッグセッションを終了します

• lldb_list_sessions(): アクティブな LLDB セッションをすべて一覧表示します

• lldb_command(session_id, command): 任意の LLDB コマンドを実行します

GDB ツール

• gdb_start(gdb_path): 新しい GDB デバッグセッションを開始します

• gdb_terminate(session_id): GDB デバッグセッションを終了します

• gdb_list_sessions(): アクティブな GDB セッションをすべて一覧表示します

• gdb_command(session_id, command): 任意の GDB コマンドを実行します

高度なデバッガー操作には *_command() 関数を使用してください。LLM クライアントはすでにその使い方を知っているはずですが、言及しておいても問題ありません。

ステータスの確認

デバッガーの利用可能性を確認できます：

from modules.lldb import LLDBSessionManager
from modules.gdb import GDBSessionManager

print("LLDB available:", LLDBSessionManager.is_available())
print("GDB available:", GDBSessionManager.is_available())

テスト

uv run python run-tests.py --check-deps
uv run python run-tests.py --type all

例

examples ディレクトリにサンプルプロンプトがあります。

サンプルバイナリは arm64 と amd64 用にコンパイルされています。システムアーキテクチャに一致するものを選択してください。

ライセンス

このプロジェクトは GNU Version 3.0 License の下でライセンスされています。詳細は LICENSE ファイルを参照してください。