IDAssistMCP

Plugin de servidor MCP (Protocolo de Contexto de Modelo) independiente para IDA Pro 9.x que expone las capacidades de análisis de IDA a clientes LLM como Claude Desktop.

Características

• 41 herramientas MCP que cubren análisis binario, descompilación, referencias cruzadas, gestión de símbolos, sistema de tipos, navegación, parcheo, exportación y más
• 6 herramientas consolidadas con parámetros action/format/direction para comentarios, variables, tipos, referencias cruzadas, marcadores y código
• 8 recursos MCP para metadatos binarios navegables (triaje, funciones, importaciones, exportaciones, cadenas, información, segmentos, secciones)
• 7 indicaciones guiadas para flujos de trabajo comunes de ingeniería inversa (análisis de funciones, identificación de vulnerabilidades, documentación, trazado de flujo de datos, comparación de funciones, recuperación de estructuras, análisis de protocolos de red)
• Transportes SSE y HTTP Streamable a través del servidor ASGI Hypercorn
• Modificaciones IDB seguras para hilos a través del envoltorio execute_on_main_thread()
• Caché de análisis LRU para operaciones costosas como la descompilación
• Gestor de tareas asíncronas para operaciones de larga duración
• Configuración Pydantic con soporte de variables de entorno (prefijo IDASSISTMCP_)

Instalación

Requisitos previos

• IDA Pro 9.x con Python 3.10+
• Descompilador Hex-Rays (opcional, para herramientas de descompilación)

Opción 1: Gestor de plugins de IDA (recomendado)

hcli plugin install idassistmcp

Esto instala automáticamente el plugin y sus dependencias de Python.

Opción 2: Instalación manual (desde el archivo comprimido de la versión)

Descarga el archivo zip de la última versión desde GitHub Releases y extráelo en tu directorio de plugins de IDA:

Linux / macOS:

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

Windows: Extrae el zip en %APPDATA%\Hex-Rays\IDA Pro\plugins\.

Luego instala las dependencias usando el Python incluido con IDA (no el Python de tu 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"

Reemplaza <IDA_INSTALL_DIR> con la ruta de instalación de IDA Pro.

Consejo: También puedes usar la variable de entorno IDAUSR para especificar un directorio de plugins personalizado.

Uso

Iniciando el servidor

1. Abre un binario en IDA Pro
2. Presiona Ctrl+Shift+M o ve a Edit > Plugins > IDAssistMCP
3. La URL del servidor MCP se mostrará en la ventana de salida de IDA
4. Presiona Ctrl+Shift+M nuevamente para detener el servidor

Configuración de Claude Desktop

Agrega a tu claude_desktop_config.json de Claude Desktop:

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

Variables de entorno

Configura mediante variables de entorno con el prefijo IDASSISTMCP_:

Variable	Default	Descripción
IDASSISTMCP_SERVER__HOST	localhost	Dirección de enlace del servidor
IDASSISTMCP_SERVER__PORT	9080	Puerto del servidor
IDASSISTMCP_SERVER__TRANSPORT	streamablehttp	Tipo de transporte (sse o streamablehttp)
IDASSISTMCP_DEBUG	false	Habilitar modo depuración
IDASSISTMCP_LOG_LEVEL	INFO	Nivel de registro

Referencia de herramientas

Gestión binaria (2)

Herramienta	Descripción
list_binaries	Listar el binario cargado actualmente
get_binary_info	Metadatos detallados del binario (arquitectura, hashes, segmentos)

Análisis de código (4)

Herramienta	Descripción
get_code	Obtener código de función — format: 'decompile' (pseudo-C) o 'disasm' (ensamblador)
analyze_function	Análisis completo: metadatos, CFG, llamantes/llamados, descompilación
get_basic_blocks	Bloques básicos del CFG con sucesores/predecesores
get_function_stack_layout	Diseño del marco de pila (variables locales, argumentos, registros guardados)

Referencias cruzadas (1 consolidada)

Herramienta	Acciones	Descripción
xrefs	direction: to/from/both, include_calls: bool	Referencias cruzadas y llamantes/llamados opcionales para una dirección

Comentarios (1 consolidada)

Herramienta	Acciones	Descripción
comments	action: get, set, list, remove	Gestionar comentarios (normales, repetibles, de función)

Variables (1 consolidada)

Herramienta	Acciones	Descripción
variables	action: list, rename	Listar variables locales, o renombrar variables locales/globales con scope: auto, local, global

Tipos (2 — 1 consolidada + 1 independiente)

Herramienta	Acciones / Descripción
types	action: list, set, create_struct, create_enum — gestionar tipos IDB
get_classes	Listar tipos struct/class de la biblioteca de tipos

Descubrimiento de funciones (5)

Herramienta	Descripción
get_functions	Todas las funciones con filtrado y paginación
search_functions_by_name	Buscar por patrón de nombre y filtros de tamaño
get_function_by_name	Búsqueda por nombre exacto
get_function_by_address	Búsqueda por dirección
get_function_statistics	Estadísticas agregadas (conteos, tamaños, top-10)

Gestión de símbolos (2)

Herramienta	Descripción
rename_symbol	Renombrar cualquier símbolo (función o dato)
batch_rename	Renombrar múltiples símbolos por lotes

Información binaria (5)

Herramienta	Descripción
get_imports	Tabla de importaciones agrupada por módulo
get_exports	Tabla de exportaciones
get_strings	Tabla de cadenas con paginación
get_segments	Segmentos de memoria con permisos
get_entry_points	Todos los puntos de entrada del binario

Análisis de datos (6)

Herramienta	Descripción
read_memory	Leer bytes en bruto en una dirección
get_data_at	Obtener datos tipados en una dirección
search_bytes	Búsqueda de patrón de bytes binarios
search_strings	Búsqueda de cadenas con paginación
create_data_var	Definir variable de datos en una dirección (byte/word/dword/qword/float/ascii/tipo C)
get_data_vars	Listar variables de datos definidas (elementos que no son código)

Parcheo (3)

Herramienta	Descripción
patch_bytes	Parchear bytes en bruto en el IDB
assemble_code	Ensamblar texto de instrucción en una dirección y opcionalmente parchearlo
export_program	Exportar el binario parcheado o la base de datos de IDA al disco

Navegación (4)

Herramienta	Descripción
navigate_to	Mover el cursor de IDA a una dirección
bookmarks	Gestión consolidada de marcadores - acciones: list, set, remove
get_current_address	Obtener dirección y contexto en la posición del cursor
get_current_function	Obtener información de la función en la posición del cursor