
Servidor MCP headless de IDA Pro para análisis binario asistido por IA, impulsado por idalib
CLI de IDA sin interfaz gráfica y kit de herramientas basado en skills para el análisis de binarios en macOS y Linux. ida-cli selecciona automáticamente un backend de ejecución, inicia automáticamente un servidor local cuando es necesario, y expone la misma superficie como una CLI plana, un transporte MCP stdio y un transporte MCP Streamable HTTP.
ida-cli (cliente + servicio en un solo ejecutable)ida-cli (skill/SKILL.md) para entornos de agentesLa capa de servicio subyacente de worker / router es iniciada y detenida por la CLI automáticamente. Solo necesitas ejecutar serve / serve-http explícitamente cuando realmente quieras un servicio de larga duración y direccionable externamente.
Requisitos de ejecución: IDA 9.4/9.5 y Python >=3.11. Todas las operaciones de base de datos utilizan el entorno dedicado y fijado Nexus 0.13.4 / Domain 0.5.1. Las dependencias faltantes o los parches no coincidentes fallan explícitamente. Las compilaciones de Rust no necesitan el SDK de IDA.
En los entornos de ejecución compatibles con IDA 9.x, ida-cli puede:
.i64 en cachéread_* y convert_numberrun_scriptTodas las herramientas utilizan Nexus con errores de capacidad explícitos. Consulta docs/TOOLS.md para ver la lista de herramientas generada.
El punto de entrada predeterminado es la skill ida-cli, no una instalación manual de la CLI.
# list the skill exposed by this repository
npx -y skills add https://github.com/cpkt9762/ida-cli --list
# install the ida-cli skill for Codex
npx -y skills add https://github.com/cpkt9762/ida-cli --skill ida-cli --agent codex --yes --global
Después de la instalación, la skill incluye su propio wrapper de arranque:
~/.agents/skills/ida-cli/scripts/ida-cli.sh --help
~/.agents/skills/ida-cli/scripts/ida-cli.sh probe-runtime
~/.agents/skills/ida-cli/scripts/ida-cli.sh --path /path/to/binary list-functions --limit 20
Si falta ida-cli, el wrapper lo instala a través del instalador del repositorio antes de reenviar el comando.
Use esto solo si desea la CLI independiente sin pasar por la skill.
curl -fsSL https://raw.githubusercontent.com/cpkt9762/ida-cli/master/scripts/install.sh | bash -s -- --add-path
Variantes útiles:
# install a specific release
curl -fsSL https://raw.githubusercontent.com/cpkt9762/ida-cli/master/scripts/install.sh | bash -s -- --tag v0.9.3 --add-path
# build directly from a branch or ref
curl -fsSL https://raw.githubusercontent.com/cpkt9762/ida-cli/master/scripts/install.sh | bash -s -- --ref master --build-from-source --add-path
Notas:
~/.local/bin/ida-cli de forma predeterminada.--add-path añade ese directorio bin a tu archivo rc del shell..app en /Applications o ~/Applications e imprime la seleccionada y las demás candidatas. 9.10 es más reciente que 9.9; los componentes finales con cero son iguales, y el orden canónico de rutas resuelve los empates. Un IDADIR explícito tiene prioridad. Un wheel/runtime seleccionado incompatible falla de forma explícita. Si no se encuentra ningún candidato, la instalación falla con instrucciones para establecer IDADIR.IDADIR explícito lo sobrescribe; se aceptan las rutas .app, Contents y del runtime. Consulta comparación de versiones y comprobaciones del runtime.git clone https://github.com/cpkt9762/ida-cli.git
cd ida-cli
export IDADIR="/Applications/IDA Professional 9.5.app/Contents/MacOS" # or a Linux install
cargo build --bin ida-cli
./target/debug/ida-cli --help
ida-cli está orientado al cliente. Cualquier subcomando de cliente inicia automáticamente un servidor local
Streamable-HTTP vinculado a un puerto aleatorio y escribe
/tmp/ida-cli.socket para su descubrimiento:
./target/debug/ida-cli --path /path/to/sample.bin list-functions --limit 20
./target/debug/ida-cli --path /path/to/sample.bin decompile --addr 0x140001000
./target/debug/ida-cli --path /path/to/sample.bin raw '{"method":"get_xrefs_to","params":{"address":"0x140001000"}}'
Para ver qué bases de datos mantiene abiertas actualmente el daemon, y qué clientes las mantienen, ejecute list-idbs (herramienta MCP: list_idbs). Ejecútelo antes de reconstruir o reemplazar un .i64, por ejemplo con idat: una base de datos que aún aparece en la lista está mantenida abierta por el daemon, y idat falla en una base de datos que está abierta en otro lugar. La respuesta es {"count": N, "idbs": [...]}; cada entrada tiene el db_handle, la ruta de entrada y la ruta del .i64, un id opaco del cliente que la abrió, cuándo se abrió, el proceso worker, si es la base de datos activa, y los clientes que aún mantienen referencias. Los tokens de cierre nunca se devuelven.
./target/debug/ida-cli list-idbs --json
Para obtener la dirección detrás de cada línea de pseudocódigo, añada --line-addresses a
decompile (MCP y RPC: line_addresses: true en decompile_function). La
respuesta pasa a ser {"code": ..., "lines": [...]}: code es el texto habitual y
cada entrada de lines es {"line", "text", "addresses"}. line cuenta desde 1,
text es esa línea de code, y addresses son las direcciones de IDA (cadenas
hexadecimales, ascendentes, sin duplicados) de los elementos del ctree sobre los que Hex-Rays ancló
la línea. Una línea puede corresponder a varias direcciones no contiguas, y la lista no es
cada instrucción de la sentencia. La firma y las declaraciones locales no tienen
ninguna; {, }, else y las líneas en blanco pueden llevar la dirección del bloque o
if al que pertenecen (la entrada de la función para las llaves más externas). La sugerencia de
renombrado sub_ no se añade en este modo. Hex-Rays puede imprimir una función muy grande
de forma diferente de una llamada a otra, así que use code y lines solo de la misma
respuesta. Nexus admite este modo. A través del socket de la CLI, una respuesta
grande se almacena en la caché de respuestas como cualquier otra (IDA_MCP_MAX_INLINE_BYTES).
{"line": 6, "text": " while ( a1 != 1 )", "addresses": ["0x10000033c", "0x100000340"]}