Multi-Debugger-MCP-Server (LLDB und GDB)

Ein Model-Context-Protocol-Server, der Debugging-Funktionen für sowohl GDB- als auch LLDB-Debugger bereitstellt, zur Verwendung mit Claude Desktop, VSCode Copilot oder anderen KI-Assistenten.

Schnellstart

uv sync
uv venv
uv run server.py

Related MCP server: LLDB MCP Server

Integration

Beachten Sie, dass Sie uv run verwenden können, um das Skript server.py auszuführen, oder Sie können uv venv verwenden, um eine virtuelle Umgebung zu erstellen und dann /home/youruser/dev/personal/GDB-MCP/.venv/bin/python /home/youruser/dev/personal/GDB-MCP/server.py ausführen.

Claude Desktop

Fügen Sie zu Ihrer claude_desktop_config.json hinzu:

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

VSCode Copilot

Wenn Sie WSL verwenden:

 "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"
        ]
      }
    }
  }

Wenn Sie WSL nicht verwenden:

  "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"]
    }
  }
}

Experimentelle LLDB-Unterstützung (macOS)

Dieses Projekt enthält experimentelle native LLDB-Unterstützung neben GDB, mit automatischer Debugger-Auswahl.

Installation

Um die LLDB-Unterstützung unter macOS zu aktivieren, installieren Sie LLVM (das LLDB enthält) und python über Homebrew:

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

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

Verfügbare Werkzeuge

Einheitliche Werkzeuge

• debugger_status(): Verfügbare Debugger und deren Status anzeigen

• debugger_start(): Debugging-Sitzung mit automatisch erkanntem Debugger starten

• debugger_terminate(session_id): Debugging-Sitzung beenden

• debugger_list_sessions(): Alle aktiven Debugging-Sitzungen auflisten

• debugger_command(session_id, command): Debugger-Befehl ausführen

LLDB-Werkzeuge

• lldb_start(): Neue LLDB-Debugging-Sitzung starten

• lldb_terminate(session_id): LLDB-Debugging-Sitzung beenden

• lldb_list_sessions(): Alle aktiven LLDB-Sitzungen auflisten

• lldb_command(session_id, command): Beliebigen LLDB-Befehl ausführen

GDB-Werkzeuge

• gdb_start(gdb_path): Neue GDB-Debugging-Sitzung starten

• gdb_terminate(session_id): GDB-Debugging-Sitzung beenden

• gdb_list_sessions(): Alle aktiven GDB-Sitzungen auflisten

• gdb_command(session_id, command): Beliebigen GDB-Befehl ausführen

Verwenden Sie die Funktionen *_command() für alle fortgeschrittenen Debugger-Operationen. Ihr LLM-Client sollte bereits wissen, wie man sie verwendet, aber es schadet nicht, es zu erwähnen.

Status prüfen

Sie können die Verfügbarkeit des Debuggers überprüfen:

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

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

Testen

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

Beispiele

Schauen Sie sich das Verzeichnis examples für Beispiel-Prompts an.

Die Beispiel-Binärdateien sind für arm64 und amd64 kompiliert. Wählen Sie diejenige aus, die zu Ihrer Systemarchitektur passt.

Lizenz

Dieses Projekt ist unter der GNU-Lizenz Version 3.0 lizenziert. Einzelheiten finden Sie in der Datei LICENSE.