LLDB MCP-Integration

Dieses Projekt bietet eine Integration des Model-Context-Protokolls (MCP) für LLDB, die es KI-Assistenten wie Claude ermöglicht, über eine standardisierte Schnittstelle mit Ihren Debugging-Sitzungen zu interagieren.

Übersicht

Die Integration besteht aus zwei Hauptkomponenten:

server.py - Ein MCP-Server, der mit Claude (oder anderen MCP-Clients) kommuniziert
lldb_plugin.py - Ein Plugin, das innerhalb von LLDB läuft und Debugger-Funktionalität über JSON-RPC bereitstellt

Diese Architektur ermöglicht es Claude, Ihnen beim Debuggen von Code zu helfen, indem es direkt über natürliche Sprache mit LLDB interagiert. Der MCP-Server fungiert als Brücke, übersetzt die Anfragen von Claude in LLDB-Befehle und gibt die Ergebnisse in einem strukturierten Format zurück.

Installation

Voraussetzungen

Python 3.10 oder höher
LLDB mit Python-Bindungen
fastmcp Python-Paket (für Claude Desktop-Integration)

Einrichtung

Klonen Sie dieses Repository:

git clone https://github.com/ant4g0nist/lldb-mcp.git
cd lldb-mcp

Installieren Sie die erforderlichen Abhängigkeiten:
```
pip install "fastmcp>=1.2.0" httpx
```
oder
```
uv install "fastmcp>=1.2.0" httpx
```

Verwendung

Methode 1: Verwendung mit Claude for Desktop

Stellen Sie sicher, dass Claude for Desktop installiert und auf die neueste Version aktualisiert ist.
Konfigurieren Sie Claude for Desktop zur Verwendung des LLDB MCP-Servers, indem Sie Folgendes bearbeiten:
- Pfad: ~/Library/Application Support/Claude/claude_desktop_config.json

Aktualisieren Sie die Pfade und fügen Sie die LLDB MCP-Konfiguration hinzu:

{
  "mcpServers": {
    "lldb": {
      "command": "/path/to/your/.local/bin/uv",
      "args": [
        "--directory",
        "/path/to/your/lldb-mcp/llmcp",
        "run",
        "lldb_mcp.py"
      ]
    }
  }
}

Starten Sie Claude for Desktop neu.
Starten Sie eine Debugging-Sitzung in LLDB und aktivieren Sie den MCP-Server mit:
```
(lldb) command script import lisa.py
```
Sie sollten nun die LLDB-Werkzeuge in Claude for Desktop sehen. Suchen Sie nach dem Hammersymbol.

Methode 2: Direkte LLDB-Integration

Wenn Sie das Plugin direkt von LLDB aus verwenden möchten, ohne Claude for Desktop:

Fügen Sie Folgendes zu Ihrer ~/.lldbinit-Datei hinzu, um das Plugin automatisch zu laden:
```
command script import /path/to/lldb_plugin.py
```
Starten Sie in Ihrer LLDB-Sitzung den MCP-Server:
```
(lldb) mcp start
```
Der Server ist unter http://localhost:13338 verfügbar, damit sich jeder MCP-Client verbinden kann.

Verfügbare LLDB-Werkzeuge

Der MCP-Server stellt die folgenden Methoden für KI-Assistenten bereit:

create_target - Erstellt ein Debug-Ziel aus einem ausführbaren Pfad
launch_process - Startet einen Prozess mit optionalen Argumenten, Umgebungsvariablen und Arbeitsverzeichnis
attach_to_process - Hängt an einen laufenden Prozess anhand der PID an
detach_from_process - Trennt sich vom aktuellen Prozess
continue_process - Setzt die Prozessausführung fort
step_over - Über die aktuelle Zeile oder Anweisung springen
step_into - In Funktionsaufruf hineinspringen
step_out - Aus der aktuellen Funktion herausspringen
set_breakpoint - Setzt einen Haltepunkt an einer bestimmten Stelle
delete_breakpoint - Löscht einen Haltepunkt anhand der ID
list_breakpoints - Listet alle Haltepunkte auf
get_backtrace - Ruft den Rückverfolgungsbericht für den aktuellen oder einen bestimmten Thread ab
get_variables - Ruft Variablen im aktuellen Frame ab
get_disassembly - Ruft die Disassemblierung um eine bestimmte Adresse oder den aktuellen PC ab
read_memory - Liest Speicher von einer bestimmten Adresse aus
get_metadata - Ruft Metadaten über die aktuelle Debugging-Sitzung ab
run_lldb_command - Führt einen beliebigen LLDB-Befehl aus
evaluate_expression - Wertet einen Ausdruck im aktuellen Kontext aus

Beispiel-Interaktionen mit Claude

Nach der Einrichtung können Sie über natürliche Sprache mit LLDB durch Claude interagieren. Einige Beispiele:

"Debuggen Sie dieses Programm bei /path/to/executable"
"Setzen Sie einen Haltepunkt bei main"
"Führen Sie das Programm mit Argumenten -v input.txt aus"
"Zeigen Sie mir die Variablen im aktuellen Frame"
"Springen Sie in den nächsten Funktionsaufruf"
"Wie sieht der aktuelle Rückverfolgungsbericht aus?"
"Werten Sie den Ausdruck ptr->data[i] aus"
"Zeigen Sie mir den Assembler-Code an der aktuellen Anweisung"

Fehlerbehebung

Plugin lädt nicht: Stellen Sie sicher, dass die Python-Umgebung von LLDB auf die erforderlichen Module zugreifen kann
Serververbindungsprobleme: Überprüfen Sie, ob Port 13338 bereits von einer anderen Anwendung verwendet wird
Claude erkennt keine Werkzeuge: Überprüfen Sie die korrekte Konfiguration in claude_desktop_config.json
Befehlsfehler: Das Plugin protokolliert Fehler in der LLDB-Konsole, überprüfen Sie diese auf Details

Mitwirken

Beiträge sind willkommen! Bitte zögern Sie nicht, Pull-Requests einzureichen oder Issues für Fehler und Feature-Wünsche zu erstellen.

lisa.py

Beliebteste