IDAssistMCP

[!IMPORTANT] Archivado previsto: Está previsto archivar IDAssistMCP ya que IDA Pro introduce un servidor MCP nativo integrado. El soporte nativo elimina la necesidad de mantener una integración MCP independiente y la mantiene alineada con el propio IDA Pro. Utilice el servidor MCP nativo de IDA Pro una vez que esté disponible en su versión instalada. Este repositorio permanecerá disponible como referencia.

Plugin de servidor MCP (Model Context Protocol) 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 de binarios, 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, xrefs, marcadores y código
• 8 recursos MCP para metadatos de binarios navegables (triage, funciones, importaciones, exportaciones, cadenas, información, segmentos, secciones)
• 7 prompts guiados 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 Streamable HTTP mediante el servidor ASGI Hypercorn
• Modificaciones de IDB seguras para hilos mediante el wrapper 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 tarball de la release)

Descargue el zip de la última release desde GitHub Releases y extráigalo en su directorio de plugins de IDA:

Linux / macOS:

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

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

A continuación, instale las dependencias usando el Python incluido con IDA (no su Python del 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"

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

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

Uso

Iniciar el servidor

1. Abra un binario en IDA Pro
2. Pulse Ctrl+Shift+M o vaya a Edit > Plugins > IDAssistMCP
3. La URL del servidor MCP se imprimirá en la ventana de salida de IDA
4. Pulse Ctrl+Shift+M de nuevo para detener el servidor

Configuración de Claude Desktop

Añada a su claude_desktop_config.json de Claude Desktop:

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

Variables de entorno

Configure mediante variables de entorno con el prefijo IDASSISTMCP_:

Variable	Predeterminado	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	Activar modo de depuración
IDASSISTMCP_LOG_LEVEL	INFO	Nivel de log

Referencia de herramientas

Gestión de binarios (2)

Herramienta	Descripción
list_binaries	Lista 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	Obtiene el código de la función — format: 'decompile' (pseudo-C) o 'disasm' (ensamblador)
analyze_function	Análisis exhaustivo: metadatos, CFG, llamadores/llamados, descompilación
get_basic_blocks	Bloques básicos del CFG con sucesores/predecesores
get_function_stack_layout	Diseño del marco de pila (locales, argumentos, registros guardados)

Referencias cruzadas (1 consolidada)

Herramienta	Acciones	Descripción
xrefs	direction: to/from/both, include_calls: bool	Xrefs y llamadores/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 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 del 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 (recuentos, 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 varios símbolos en lote

Información del binario (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 patrones de bytes binarios
search_strings	Búsqueda de cadenas con paginación
create_data_var	Definir una 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