
Server MCP headless per IDA Pro per l'analisi binaria assistita da IA, basato su idalib
CLI IDA headless e toolkit skill-first per l'analisi di binari su macOS e
Linux. ida-cli seleziona automaticamente un backend runtime, avvia automaticamente un server locale
quando necessario ed espone la stessa superficie come CLI piatta, trasporto MCP
stdio e trasporto MCP Streamable HTTP.
ida-cli (client + servizio in un unico eseguibile)ida-cli (skill/SKILL.md) per ambienti agentIl livello sottostante del servizio worker / router viene avviato e arrestato
automaticamente dalla CLI. È necessario eseguire serve / serve-http esplicitamente
solo quando si desidera effettivamente un servizio a lunga durata e indirizzabile dall'esterno.
Requisiti runtime: IDA 9.4/9.5 e Python >=3.11. Tutte le operazioni sul database utilizzano l'ambiente dedicato e fissato Nexus 0.13.4 / Domain 0.5.1. Dipendenze mancanti o patch non corrispondenti falliscono esplicitamente. Le build Rust non richiedono l'IDA SDK.
Sui runtime IDA 9.x supportati, ida-cli può:
.i64 in cacheread_* e convert_numberrun_scriptTutti gli strumenti utilizzano Nexus con errori di capacità espliciti. Vedere docs/TOOLS.md per l'elenco generato degli strumenti.
Il punto di ingresso predefinito è la skill ida-cli, non un'installazione manuale della 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
Dopo l'installazione, la skill include il proprio wrapper di bootstrap:
~/.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
Se ida-cli è assente, il wrapper lo installa tramite l'installer del repository prima di inoltrare il comando.
Usa questa opzione solo se desideri la CLI standalone senza passare attraverso la skill.
curl -fsSL https://raw.githubusercontent.com/cpkt9762/ida-cli/master/scripts/install.sh | bash -s -- --add-path
Varianti utili:
# 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
Note:
~/.local/bin/ida-cli per impostazione predefinita.--add-path aggiunge quella directory bin al file rc della tua shell..app numerica più recente sotto /Applications o ~/Applications e stampa quella selezionata e le altre candidate. 9.10 è più recente di 9.9; i componenti finali pari a zero sono equivalenti, con l'ordine canonico dei percorsi che risolve i pareggi. Un IDADIR esplicito ha la priorità. Un wheel/runtime selezionato incompatibile fallisce esplicitamente. Se non viene trovato alcun candidato, l'installazione fallisce con istruzioni per impostare IDADIR.IDADIR esplicito lo sovrascrive; sono accettati i percorsi .app, Contents e runtime. Vedi confronto delle versioni e controlli 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 è client-first. Qualsiasi sottocomando client avvia automaticamente un server locale
Streamable-HTTP associato a una porta casuale e scrive
/tmp/ida-cli.socket per la scoperta:
./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"}}'
Per vedere quali database il daemon tiene attualmente aperti, e quali client
li detengono, eseguire list-idbs (strumento MCP: list_idbs). Eseguirlo prima di ricostruire
o sostituire un .i64, ad esempio con idat: un database ancora
elencato è tenuto aperto dal daemon, e idat fallisce su un database che è
aperto altrove. La risposta è {"count": N, "idbs": [...]}; ogni voce ha
il db_handle, il percorso di input e il percorso .i64, un id opaco del
client che l'ha aperto, quando è stato aperto, il processo worker, se è
il database attivo, e i client che detengono ancora riferimenti. I token
di chiusura non vengono mai restituiti.
./target/debug/ida-cli list-idbs --json
Per ottenere l'indirizzo dietro ogni riga di pseudocodice, aggiungi --line-addresses a
decompile (MCP e RPC: line_addresses: true su decompile_function). La
risposta diventa {"code": ..., "lines": [...]}: code è il testo abituale e
ogni voce di lines è {"line", "text", "addresses"}. line conta da 1,
text è quella riga di code, e addresses sono gli indirizzi IDA (stringhe
esadecimali, in ordine crescente, senza duplicati) degli elementi del ctree su cui Hex-Rays si è ancorato
per la riga. Una riga può corrispondere a più indirizzi non contigui, e la lista non è
ogni istruzione dell'istruzione. La firma e le dichiarazioni locali non ne hanno
nessuno; {, }, else e le righe vuote possono portare l'indirizzo del blocco o
dell'if che le possiede (l'ingresso della funzione per le parentesi più esterne). Il suggerimento
di rinomina sub_ non viene aggiunto in questa modalità. Hex-Rays può stampare una funzione molto grande
in modo diverso da una chiamata all'altra, quindi usa code e lines solo dalla stessa
risposta. Nexus supporta questa modalità. Tramite il socket CLI una grande
risposta viene memorizzata nella cache delle risposte come qualsiasi altra (IDA_MCP_MAX_INLINE_BYTES).
{"line": 6, "text": " while ( a1 != 1 )", "addresses": ["0x10000033c", "0x100000340"]}
I comandi il cui primo argomento è un sottocomando di servizio (serve,
serve-http, serve-worker, probe-runtime) entrano invece in modalità servizio:
./target/debug/ida-cli serve # stdio MCP transport
./target/debug/ida-cli serve-http --bind 127.0.0.1:8765
./target/debug/ida-cli probe-runtime