Intégration MCP LLDB

Ce projet fournit une intégration du Model-Context Protocol (MCP) pour LLDB, permettant à des assistants IA comme Claude d'interagir avec vos sessions de débogage via une interface standardisée.

Aperçu

L'intégration se compose de deux composants principaux :

server.py - Un serveur MCP qui communique avec Claude (ou d'autres clients MCP)
lldb_plugin.py - Un plugin qui s'exécute dans LLDB et expose les fonctionnalités du débogueur via JSON-RPC

Cette architecture permet à Claude de vous aider à déboguer du code en interagissant directement avec LLDB en langage naturel. Le serveur MCP agit comme un pont, traduisant les requêtes de Claude en commandes LLDB et renvoyant les résultats dans un format structuré.

Installation

Prérequis

Python 3.10 ou supérieur
LLDB avec les liaisons Python
Paquet Python fastmcp (pour l'intégration avec Claude Desktop)

Configuration

Clonez ce dépôt :

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

Installez les dépendances requises :

pip install "fastmcp>=1.2.0" httpx

uv install "fastmcp>=1.2.0" httpx

Utilisation

Méthode 1 : Utilisation avec Claude Desktop

Assurez-vous que Claude Desktop est installé et mis à jour vers la dernière version.
Configurez Claude Desktop pour utiliser le serveur MCP LLDB en modifiant :
- chemin : ~/Library/Application Support/Claude/claude_desktop_config.json

Mettez à jour les chemins et ajoutez la configuration MCP LLDB :

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

Redémarrez Claude Desktop.
Lancez une session de débogage dans LLDB et activez le serveur MCP avec :
```
(lldb) command script import lisa.py
```
Vous devriez maintenant voir les outils LLDB disponibles dans Claude Desktop. Cherchez l'icône du marteau.

Méthode 2 : Intégration directe dans LLDB

Si vous préférez utiliser le plugin directement depuis LLDB sans Claude Desktop :

Ajoutez ce qui suit à votre fichier ~/.lldbinit pour charger le plugin automatiquement :
```
command script import /path/to/lldb_plugin.py
```
Dans votre session LLDB, démarrez le serveur MCP :
```
(lldb) mcp start
```
Le serveur sera disponible à l'adresse http://localhost:13338 pour que tout client MCP puisse s'y connecter.

Outils LLDB disponibles

Le serveur MCP expose les méthodes suivantes pour les assistants IA :

create_target - Crée une cible de débogage à partir d'un chemin d'exécutable
launch_process - Lance un processus avec des arguments optionnels, des variables d'environnement et un répertoire de travail
attach_to_process - S'attache à un processus en cours d'exécution par son PID
detach_from_process - Se détache du processus actuel
continue_process - Continue l'exécution du processus
step_over - Passe à la ligne ou instruction suivante
step_into - Entre dans l'appel de fonction
step_out - Sort de la fonction actuelle
set_breakpoint - Définit un point d'arrêt à un emplacement spécifié
delete_breakpoint - Supprime un point d'arrêt par son ID
list_breakpoints - Liste tous les points d'arrêt
get_backtrace - Obtient la trace d'appel pour le thread actuel ou un thread spécifié
get_variables - Obtient les variables du cadre actuel
get_disassembly - Obtient le désassemblage autour d'une adresse spécifiée ou du PC actuel
read_memory - Lit la mémoire à une adresse spécifique
get_metadata - Obtient des métadonnées sur la session de débogage actuelle
run_lldb_command - Exécute une commande LLDB arbitraire
evaluate_expression - Évalue une expression dans le contexte actuel

Exemples d'interactions avec Claude

Une fois configuré, vous pouvez interagir avec LLDB via Claude en langage naturel. Quelques exemples :

"Déboguez ce programme à /path/to/executable"
"Placez un point d'arrêt à main"
"Exécutez le programme avec les arguments -v input.txt"
"Montrez-moi les variables dans le cadre actuel"
"Entrez dans l'appel de fonction suivant"
"Quelle est la trace d'appel actuelle ?"
"Évaluez l'expression ptr->data[i]"
"Montrez-moi le code assembleur à l'instruction actuelle"

Dépannage

Plugin ne se charge pas : assurez-vous que l'environnement Python de LLDB peut accéder aux modules nécessaires
Problèmes de connexion au serveur : vérifiez si le port 13338 est déjà utilisé par une autre application
Claude ne détecte pas les outils : vérifiez la configuration correcte dans claude_desktop_config.json
Erreurs de commande : le plugin enregistre les erreurs dans la console LLDB, vérifiez-y pour les détails

Contribution

Les contributions sont les bienvenues ! N'hésitez pas à soumettre des pull requests ou à créer des issues pour les bugs et les demandes de fonctionnalités.

lisa.py

Populaires