Integração LLDB MCP

Este projeto fornece uma integração do Protocolo de Contexto de Modelo (MCP) para o LLDB, permitindo que assistentes de IA como o Claude interajam com suas sessões de depuração através de uma interface padronizada.

Visão Geral

A integração consiste em dois componentes principais:

1. server.py - Um servidor MCP que se comunica com o Claude (ou outros clientes MCP)
2. lldb_plugin.py - Um plugin que executa dentro do LLDB e expõe funcionalidades do depurador via JSON-RPC

Esta arquitetura permite que o Claude ajude você a depurar código interagindo diretamente com o LLDB através de linguagem natural. O servidor MCP atua como uma ponte, traduzindo as requisições do Claude em comandos LLDB e retornando resultados em um formato estruturado.

Instalação

Pré-requisitos

• Python 3.10 ou superior
• LLDB com bindings Python
• Pacote Python fastmcp (para integração com Claude Desktop)

Configuração

1. Clone este repositório:

   root@kitploit:~

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

2. Instale as dependências necessárias:

   root@kitploit:~

   pip install "fastmcp>=1.2.0" httpx
   

   ou

   root@kitploit:~

   uv install "fastmcp>=1.2.0" httpx
   

Uso

Método 1: Usando com o Claude Desktop

1. Certifique-se de que o Claude Desktop está instalado e atualizado para a versão mais recente.

2. Configure o Claude Desktop para usar o servidor MCP LLDB editando:

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

3. Atualize os caminhos e adicione a configuração do LLDB MCP:

   root@kitploit:~

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

4. Reinicie o Claude Desktop.

5. Inicie uma sessão de depuração no LLDB e ative o servidor MCP com:

   root@kitploit:~

   (lldb) command script import lisa.py
   

6. Agora você deve ver as ferramentas LLDB disponíveis no Claude Desktop. Procure pelo ícone de martelo.

Método 2: Integração Direta com LLDB

Se preferir usar o plugin diretamente do LLDB sem o Claude Desktop:

1. Adicione o seguinte ao seu arquivo ~/.lldbinit para carregar o plugin automaticamente:

   root@kitploit:~

   command script import /path/to/lldb_plugin.py
   

2. Na sua sessão LLDB, inicie o servidor MCP:

   root@kitploit:~

   (lldb) mcp start
   

3. O servidor estará disponível em http://localhost:13338 para que qualquer cliente MCP se conecte.

Ferramentas LLDB Disponíveis

O servidor MCP expõe os seguintes métodos para assistentes de IA:

• create_target - Cria um alvo de depuração a partir de um caminho de executável
• launch_process - Lança um processo com argumentos opcionais, variáveis de ambiente e diretório de trabalho
• attach_to_process - Anexa a um processo em execução pelo PID
• detach_from_process - Desanexa do processo atual
• continue_process - Continua a execução do processo
• step_over - Passa sobre a linha ou instrução atual
• step_into - Entra em chamada de função
• step_out - Sai da função atual
• set_breakpoint - Define um ponto de interrupção em um local especificado
• delete_breakpoint - Exclui um ponto de interrupção pelo ID
• list_breakpoints - Lista todos os pontos de interrupção
• get_backtrace - Obtém o backtrace para a thread atual ou thread especificada
• get_variables - Obtém variáveis no quadro atual
• get_disassembly - Obtém desmontagem ao redor do endereço especificado ou PC atual
• read_memory - Lê memória de um endereço específico
• get_metadata - Obtém metadados sobre a sessão de depuração atual
• run_lldb_command - Executa um comando LLDB arbitrário
• evaluate_expression - Avalia expressão no contexto atual

Exemplos de Interações com o Claude

Uma vez configurado, você pode interagir com o LLDB através do Claude usando linguagem natural. Alguns exemplos:

• "Depure este programa em /path/to/executable"
• "Defina um ponto de interrupção em main"
• "Execute o programa com argumentos -v input.txt"
• "Mostre-me as variáveis no quadro atual"
• "Entre na próxima chamada de função"
• "Qual é o backtrace agora?"
• "Avalie a expressão ptr->data[i]"
• "Mostre-me o código assembly na instrução atual"

Solução de Problemas

• Plugin não carregando: Certifique-se de que o ambiente Python do LLDB pode acessar os módulos necessários
• Problemas de conexão do servidor: Verifique se a porta 13338 já está em uso por outro aplicativo
• Claude não detectando ferramentas: Verifique a configuração correta em claude_desktop_config.json
• Erros de comando: O plugin registra erros no console do LLDB, verifique lá para detalhes

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para enviar pull requests ou criar issues para bugs e solicitações de funcionalidades.

Licença

Licença Apache

A FAZER

• Atualizar manuais de instrução
• Adicionar mais casos de teste

Créditos

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