IDAssistMCP

Servidor plugin MCP (Model Context Protocol) independente para IDA Pro 9.x que expõe as capacidades de análise do IDA para clientes LLM como o Claude Desktop.

Funcionalidades

• 41 ferramentas MCP cobrindo análise binária, descompilação, referências cruzadas, gerenciamento de símbolos, sistema de tipos, navegação, patch, exportação e muito mais
• 6 ferramentas consolidadas com parâmetros action/format/direction para comentários, variáveis, tipos, xrefs, marcadores e código
• 8 recursos MCP para metadados binários navegáveis (triagem, funções, imports, exports, strings, informações, segmentos, seções)
• 7 prompts guiados para fluxos de trabalho comuns de engenharia reversa (análise de funções, identificação de vulnerabilidades, documentação, rastreamento de fluxo de dados, comparação de funções, recuperação de structs, análise de protocolos de rede)
• Transportes SSE e HTTP Streamable via servidor ASGI Hypercorn
• Modificações IDB thread-safe via wrapper execute_on_main_thread()
• Cache de análise LRU para operações custosas como descompilação
• Gerenciador de tarefas assíncronas para operações de longa duração
• Configuração Pydantic com suporte a variáveis de ambiente (prefixo IDASSISTMCP_)

Instalação

Pré-requisitos

• IDA Pro 9.x com Python 3.10+
• Descompilador Hex-Rays (opcional, para ferramentas de descompilação)

Opção 1: Gerenciador de Plugins do IDA (recomendado)

hcli plugin install idassistmcp

Isso instala automaticamente o plugin e suas dependências Python.

Opção 2: Instalação manual (a partir do tarball de release)

Baixe o zip da versão mais recente em GitHub Releases e extraia-o no diretório de plugins do IDA:

Linux / macOS:

unzip IDAssistMCP-*.zip -d ~/.idapro/plugins/

Windows: Extraia o zip em %APPDATA%\Hex-Rays\IDA Pro\plugins\.

Em seguida, instale as dependências usando o Python empacotado com o IDA (não o Python do sistema):

Linux / macOS:

<IDA_INSTALL_DIR>/python3/bin/pip3 install -r ~/.idapro/plugins/IDAssistMCP/requirements.txt

Windows:

"<IDA_INSTALL_DIR>\python3\python.exe" -m pip install -r "%APPDATA%\Hex-Rays\IDA Pro\plugins\IDAssistMCP\requirements.txt"

Substitua <IDA_INSTALL_DIR> pelo caminho de instalação do IDA Pro.

Dica: Você também pode usar a variável de ambiente IDAUSR para especificar um diretório de plugins personalizado.

Uso

Iniciando o Servidor

1. Abra um binário no IDA Pro
2. Pressione Ctrl+Shift+M ou vá em Edit > Plugins > IDAssistMCP
3. A URL do servidor MCP será exibida na janela de saída do IDA
4. Pressione Ctrl+Shift+M novamente para parar o servidor

Configuração do Claude Desktop

Adicione ao seu claude_desktop_config.json do Claude Desktop:

{
  "mcpServers": {
    "idassistmcp": {
      "url": "http://localhost:9080/mcp"
    }
  }
}

Variáveis de Ambiente

Configure via variáveis de ambiente com o prefixo IDASSISTMCP_:

Variável	Padrão	Descrição
IDASSISTMCP_SERVER__HOST	localhost	Endereço de vinculação do servidor
IDASSISTMCP_SERVER__PORT	9080	Porta do servidor
IDASSISTMCP_SERVER__TRANSPORT	streamablehttp	Tipo de transporte (sse ou streamablehttp)
IDASSISTMCP_DEBUG	false	Ativar modo de depuração
IDASSISTMCP_LOG_LEVEL	INFO	Nível de log

Referência de Ferramentas

Gerenciamento de Binários (2)

Ferramenta	Descrição
list_binaries	Listar o binário atualmente carregado
get_binary_info	Metadados detalhados do binário (arquitetura, hashes, segmentos)

Análise de Código (4)

Ferramenta	Descrição
get_code	Obter código da função — format: 'decompile' (pseudo-C) ou 'disasm' (assembly)
analyze_function	Análise abrangente: metadados, CFG, chamadores/chamados, descompilação
get_basic_blocks	Blocos básicos do CFG com sucessores/predecessores
get_function_stack_layout	Layout do frame de pilha (locais, argumentos, registradores salvos)

Referências Cruzadas (1 consolidada)

Ferramenta	Ações	Descrição
xrefs	direction: to/from/both, include_calls: bool	Xrefs e opcionalmente chamadores/chamados para um endereço

Comentários (1 consolidada)

Ferramenta	Ações	Descrição
comments	action: get, set, list, remove	Gerenciar comentários (regulares, repetíveis, de função)

Variáveis (1 consolidada)

Ferramenta	Ações	Descrição
variables	action: list, rename	Listar locais, ou renomear variáveis locais/globais com scope: auto, local, global

Tipos (2 — 1 consolidada + 1 independente)

Ferramenta	Ações / Descrição
types	action: list, set, create_struct, create_enum — gerenciar tipos do IDB
get_classes	Listar tipos struct/class da biblioteca de tipos

Descoberta de Funções (5)

Ferramenta	Descrição
get_functions	Todas as funções com filtragem e paginação
search_functions_by_name	Buscar por padrão de nome e filtros de tamanho
get_function_by_name	Consulta por nome exato
get_function_by_address	Consulta por endereço
get_function_statistics	Estatísticas agregadas (contagens, tamanhos, top-10)

Gerenciamento de Símbolos (2)

Ferramenta	Descrição
rename_symbol	Renomear qualquer símbolo (função ou dado)
batch_rename	Renomear em lote múltiplos símbolos

Informações do Binário (5)

Ferramenta	Descrição
get_imports	Tabela de importações agrupada por módulo
get_exports	Tabela de exportações
get_strings	Tabela de strings com paginação
get_segments	Segmentos de memória com permissões
get_entry_points	Todos os pontos de entrada do binário

Análise de Dados (6)

Ferramenta	Descrição
read_memory	Ler bytes brutos em um endereço
get_data_at	Obter dado tipado em um endereço
search_bytes	Busca por padrão de bytes binários
search_strings	Busca por strings com paginação
create_data_var	Definir variável de dado em um endereço (byte/word/dword/qword/float/ascii/tipo C)
get_data_vars	Listar variáveis de dado definidas (itens que não são código)

Patch (3)

Ferramenta	Descrição
patch_bytes	Aplicar patch de bytes brutos no IDB
assemble_code	Montar texto de instrução em um endereço e opcionalmente aplicar patch
export_program	Exportar o binário patcheado ou banco de dados IDA para disco

Navegação (4)

Ferramenta	Descrição
navigate_to	Mover cursor do IDA para um endereço
bookmarks	Gerenciamento consolidado de marcadores - ações: list, set, remove
get_current_address	Obter endereço e contexto na posição do cursor
get_current_function	Obter informação da função na posição do cursor

Gerenciamento de Tarefas (4)

Ferramenta	Descrição
start_task	Iniciar tarefa assíncrona em segundo plano
get_task_status	Verificar progresso da tarefa
cancel_task	Cancelar tarefa em execução
list_tasks	Listar todas as tarefas assíncronas

Estrutura do Projeto