Integración MCP de LLDB

Este proyecto proporciona una integración del Protocolo de Contexto de Modelo (MCP) para LLDB, permitiendo que asistentes de IA como Claude interactúen con tus sesiones de depuración a través de una interfaz estandarizada.

Descripción general

La integración consta de dos componentes principales:

1. server.py - Un servidor MCP que se comunica con Claude (u otros clientes MCP)
2. lldb_plugin.py - Un plugin que se ejecuta dentro de LLDB y expone funcionalidades del depurador a través de JSON-RPC

Esta arquitectura permite que Claude te ayude a depurar código interactuando directamente con LLDB a través del lenguaje natural. El servidor MCP actúa como un puente, traduciendo las solicitudes de Claude en comandos de LLDB y devolviendo resultados en un formato estructurado.

Instalación

Requisitos previos

• Python 3.10 o superior
• LLDB con enlaces de Python
• Paquete de Python fastmcp (para la integración con Claude Desktop)

Configuración

1. Clona este repositorio:

   root@kitploit:~

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

2. Instala las dependencias necesarias:

   root@kitploit:~

   pip install "fastmcp>=1.2.0" httpx
   

   o

   root@kitploit:~

   uv install "fastmcp>=1.2.0" httpx
   

Uso

Método 1: Usar con Claude para Desktop

1. Asegúrate de que Claude para Desktop esté instalado y actualizado a la última versión.

2. Configura Claude para Desktop para usar el servidor MCP de LLDB editando:

   • path: ~/Library/Application Support/Claude/claude_desktop_config.json

3. Actualiza las rutas y agrega la configuración MCP de LLDB:

   root@kitploit:~

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

4. Reinicia Claude para Desktop.

5. Inicia una sesión de depuración en LLDB y habilita el servidor MCP con:

   root@kitploit:~

   (lldb) command script import lisa.py
   

6. Ahora deberías ver las herramientas de LLDB disponibles en Claude para Desktop. Busca el icono de martillo.

Método 2: Integración directa con LLDB

Si prefieres usar el plugin directamente desde LLDB sin Claude para Desktop:

1. Agrega lo siguiente a tu archivo ~/.lldbinit para cargar el plugin automáticamente:

   root@kitploit:~

   command script import /path/to/lldb_plugin.py
   

2. En tu sesión de LLDB, inicia el servidor MCP:

   root@kitploit:~

   (lldb) mcp start
   

3. El servidor estará disponible en http://localhost:13338 para que cualquier cliente MCP se conecte.

Herramientas LLDB disponibles

El servidor MCP expone los siguientes métodos para los asistentes de IA:

• create_target - Crear un objetivo de depuración a partir de una ruta de ejecutable
• launch_process - Lanzar un proceso con argumentos opcionales, variables de entorno y directorio de trabajo
• attach_to_process - Adjuntar a un proceso en ejecución por PID
• detach_from_process - Desvincularse del proceso actual
• continue_process - Continuar la ejecución del proceso
• step_over - Saltar sobre la línea o instrucción actual
• step_into - Entrar en una llamada de función
• step_out - Salir de la función actual
• set_breakpoint - Establecer un punto de interrupción en una ubicación especificada
• delete_breakpoint - Eliminar un punto de interrupción por ID
• list_breakpoints - Listar todos los puntos de interrupción
• get_backtrace - Obtener el backtrace del hilo actual o de un hilo especificado
• get_variables - Obtener variables en el marco actual
• get_disassembly - Obtener desensamblado alrededor de una dirección especificada o del PC actual
• read_memory - Leer memoria de una dirección específica
• get_metadata - Obtener metadatos sobre la sesión de depuración actual
• run_lldb_command - Ejecutar un comando LLDB arbitrario
• evaluate_expression - Evaluar expresión en el contexto actual

Ejemplos de interacciones con Claude

Una vez configurado, puedes interactuar con LLDB a través de Claude usando lenguaje natural. Algunos ejemplos:

• "Depura este programa en /path/to/executable"
• "Establece un punto de interrupción en main"
• "Ejecuta el programa con argumentos -v input.txt"
• "Muéstrame las variables en el marco actual"
• "Entra en la siguiente llamada de función"
• "¿Cuál es el backtrace en este momento?"
• "Evalúa la expresión ptr->data[i]"
• "Muéstrame el código ensamblador en la instrucción actual"

Solución de problemas

• El plugin no se carga: Asegúrate de que el entorno Python de LLDB pueda acceder a los módulos necesarios
• Problemas de conexión del servidor: Verifica si el puerto 13338 ya está en uso por otra aplicación
• Claude no detecta las herramientas: Verifica la configuración correcta en claude_desktop_config.json
• Errores de comando: El plugin registra errores en la consola de LLDB, revisa allí para más detalles

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar pull requests o crear issues para errores y solicitudes de funciones.

Licencia

Licencia Apache

POR HACER

• Actualizar manuales de instrucciones
• Agregar más casos de prueba

Créditos

• voltron
• lldb
• chisel
• gef
• pixd
• hexdump
• idaref
• ida-pro-mcp