
Headless-IDA-Pro-MCP-Server für KI-gestützte Binäranalyse, basierend auf idalib
Headless-IDA-CLI und Skill-first-Toolkit für Binäranalyse unter macOS und
Linux. ida-cli wählt automatisch ein Runtime-Backend aus, startet bei Bedarf
automatisch einen lokalen Server und stellt dieselbe Oberfläche als flache CLI,
als stdio-MCP-Transport und als Streamable-HTTP-MCP-Transport bereit.
ida-cli-Binärdatei (Client + Dienst in einer ausführbaren Datei)ida-cli-Skill (skill/SKILL.md) für AgentenumgebungenDie zugrunde liegende Worker-/Router-Dienstschicht wird von der CLI
automatisch gestartet und beendet. serve / serve-http müssen nur dann
explizit ausgeführt werden, wenn tatsächlich ein langlebiger, von außen
adressierbarer Dienst gewünscht ist.
Runtime-Anforderungen: IDA 9.4/9.5 und Python >=3.11. Alle Datenbankoperationen verwenden die dedizierte, gepinnte Umgebung Nexus 0.13.4 / Domain 0.5.1. Fehlende Abhängigkeiten oder nicht übereinstimmende Patches führen zu expliziten Fehlern. Rust-Builds benötigen kein IDA SDK.
Auf unterstützten IDA-9.x-Runtimes kann ida-cli:
.i64-Datenbanken wiederverwendenread_*- und convert_number-Helfer anwendenrun_script ausführenAlle Tools verwenden Nexus mit expliziten Capability-Fehlern. Siehe docs/TOOLS.md für die generierte Tool-Liste.
Der Standard-Einstiegspunkt ist der ida-cli-Skill, nicht eine manuelle CLI-Installation.
# 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
Nach der Installation bringt der Skill seinen eigenen Bootstrap-Wrapper mit:
~/.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
Wenn ida-cli fehlt, installiert der Wrapper es über den Repository-Installer, bevor er den Befehl weiterleitet.
Verwenden Sie dies nur, wenn Sie die eigenständige CLI ohne den Umweg über das Skill wünschen.
curl -fsSL https://raw.githubusercontent.com/cpkt9762/ida-cli/master/scripts/install.sh | bash -s -- --add-path
Nützliche Varianten:
# 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
Hinweise:
~/.local/bin/ida-cli ab.--add-path hängt dieses bin-Verzeichnis an deine Shell-rc-Datei an..app-Version unter /Applications oder ~/Applications aus und gibt die ausgewählte sowie weitere Kandidaten aus. 9.10 ist neuer als 9.9; abschließende Nullkomponenten sind gleich, wobei die kanonische Pfadreihenfolge bei Gleichstand entscheidet. Ein explizit gesetztes IDADIR hat Vorrang. Ein inkompatibles ausgewähltes Wheel/Runtime schlägt explizit fehl. Wird kein Kandidat gefunden, schlägt die Installation mit Anweisungen zum Setzen von IDADIR fehl.IDADIR überschreibt sie; .app-, Contents- und Runtime-Pfade werden akzeptiert. Siehe Versionsvergleich und Runtime-Prüfungen.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 ist client-first. Jedes Client-Subkommando startet automatisch einen lokalen
Streamable-HTTP-Server, der an einen zufälligen Port gebunden ist, und schreibt
/tmp/ida-cli.socket zur Discovery:
./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"}}'
Um zu sehen, welche Datenbanken der Daemon derzeit geöffnet hält und welche Clients sie halten, führe list-idbs aus (MCP-Tool: list_idbs). Führe es vor dem Neuerstellen oder Ersetzen einer .i64 aus, zum Beispiel mit idat: Eine Datenbank, die noch aufgelistet wird, wird vom Daemon geöffnet gehalten, und idat schlägt bei einer Datenbank fehl, die anderswo geöffnet ist. Die Antwort ist {"count": N, "idbs": [...]}; jeder Eintrag enthält das db_handle, den Eingabepfad und den .i64-Pfad, eine undurchsichtige ID des Clients, der sie geöffnet hat, wann sie geöffnet wurde, den Worker-Prozess, ob es die aktive Datenbank ist, und die Clients, die noch Referenzen halten. Close-Tokens werden niemals zurückgegeben.
./target/debug/ida-cli list-idbs --json
Um die Adresse hinter jeder Zeile des Pseudocodes zu erhalten, füge --line-addresses zu
decompile hinzu (MCP und RPC: line_addresses: true bei decompile_function). Die
Antwort wird zu {"code": ..., "lines": [...]}: code ist der übliche Text und
jeder lines-Eintrag ist {"line", "text", "addresses"}. line zählt ab 1,
text ist diese Zeile von code, und addresses sind die IDA-Adressen (Hex-
Strings, aufsteigend, ohne Duplikate) der ctree-Elemente, an denen Hex-Rays in der
Zeile verankert ist. Eine Zeile kann auf mehrere nicht zusammenhängende Adressen verweisen, und die Liste ist nicht
jede Anweisung der Anweisung. Die Signatur und lokale Deklarationen haben
keine; {, }, else und Leerzeilen können die Adresse des Blocks oder
if tragen, dem sie gehören (der Funktionseinstieg für die äußersten Klammern). Der sub_-
Umbenennungshinweis wird in diesem Modus nicht hinzugefügt. Hex-Rays kann eine sehr große Funktion
von einem Aufruf zum nächsten unterschiedlich ausgeben, daher verwende code und lines nur aus derselben
Antwort. Nexus unterstützt diesen Modus. Über den CLI-Socket wird eine große
Antwort wie jede andere im Antwort-Cache gespeichert (IDA_MCP_MAX_INLINE_BYTES).
{"line": 6, "text": " while ( a1 != 1 )", "addresses": ["0x10000033c", "0x100000340"]}
Befehle, deren erstes Argument ein Service-Subcommand ist (serve,
serve-http, serve-worker, probe-runtime), wechseln stattdessen in den Service-Modus:
Entdecken Sie die meistgenutzten Tools unserer Community.
Noch keine Beliebtheitsdaten.