
Serveur MCP headless IDA Pro pour l'analyse binaire assistée par IA, propulsé par idalib
CLI IDA sans interface graphique et boîte à outils orientée skill pour l'analyse de binaires sur macOS et
Linux. ida-cli sélectionne automatiquement un backend d'exécution, démarre automatiquement un serveur local
si nécessaire, et expose la même surface sous forme de CLI plate, de transport MCP stdio,
et de transport MCP Streamable HTTP.
ida-cli (client + service dans un seul exécutable)ida-cli installable (skill/SKILL.md) pour les environnements d'agentsLa couche de service worker / routeur sous-jacente est démarrée et arrêtée par le
CLI automatiquement. Vous n'avez besoin d'exécuter serve / serve-http explicitement
que lorsque vous souhaitez réellement un service persistant et adressable de l'extérieur.
Exigences d'exécution : IDA 9.4/9.5 et Python >=3.11. Toutes les opérations sur les bases de données utilisent l'environnement dédié épinglé Nexus 0.13.4 / Domain 0.5.1. Les dépendances manquantes ou les correctifs incompatibles échouent explicitement. Les builds Rust ne nécessitent aucun SDK IDA.
Sur les runtimes IDA 9.x pris en charge, ida-cli peut :
.i64 en cacheread_* et convert_numberrun_scriptTous les outils utilisent Nexus avec des erreurs de capacité explicites. Voir docs/TOOLS.md pour la liste d'outils générée.
Le point d'entrée par défaut est le skill ida-cli, et non une installation manuelle du 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
Après l'installation, la skill fournit son propre wrapper d'amorçage :
~/.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 ida-cli est absent, le wrapper l'installe via l'installateur du dépôt avant de transmettre la commande.
À utiliser uniquement si vous souhaitez le CLI autonome sans passer par la skill.
curl -fsSL https://raw.githubusercontent.com/cpkt9762/ida-cli/master/scripts/install.sh | bash -s -- --add-path
Variantes utiles :
# 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
Remarques :
~/.local/bin/ida-cli par défaut.--add-path ajoute ce répertoire bin à votre fichier rc de shell..app la plus récente sous /Applications ou ~/Applications et affiche la version sélectionnée ainsi que les autres candidates. 9.10 est plus récent que 9.9 ; les composants finaux à zéro sont équivalents, l'ordre canonique des chemins départageant les égalités. Un IDADIR explicite est prioritaire. Un wheel/runtime sélectionné incompatible échoue explicitement. Si aucun candidat n'est trouvé, l'installation échoue avec des instructions pour définir IDADIR.IDADIR explicite le remplace ; les chemins .app, Contents et runtime sont acceptés. Voir comparaison des versions et vérifications du 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 orienté client d'abord. Toute sous-commande client démarre automatiquement un serveur
Streamable-HTTP local lié à un port aléatoire et écrit
/tmp/ida-cli.socket pour la découverte :
./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"}}'
Pour voir quelles bases de données le démon garde actuellement ouvertes, et quels clients les détiennent, exécutez list-idbs (outil MCP : list_idbs). Exécutez-le avant de reconstruire ou de remplacer un .i64, par exemple avec idat : une base de données encore listée est maintenue ouverte par le démon, et idat échoue sur une base de données ouverte ailleurs. La réponse est {"count": N, "idbs": [...]} ; chaque entrée contient le db_handle, le chemin d'entrée et le chemin .i64, un identifiant opaque du client qui l'a ouverte, le moment de son ouverture, le processus worker, s'il s'agit de la base de données active, et les clients qui détiennent encore des références. Les jetons de fermeture ne sont jamais renvoyés.
./target/debug/ida-cli list-idbs --json
Pour obtenir l'adresse derrière chaque ligne de pseudocode, ajoutez --line-addresses à
decompile (MCP et RPC : line_addresses: true sur decompile_function). La
réponse devient {"code": ..., "lines": [...]} : code est le texte habituel et
chaque entrée lines est {"line", "text", "addresses"}. line compte à partir de 1,
text est cette ligne de code, et addresses sont les adresses IDA (chaînes
hexadécimales, croissantes, sans doublons) des éléments du ctree sur lesquels Hex-Rays s'est ancré sur la
ligne. Une ligne peut correspondre à plusieurs adresses non contiguës, et la liste ne contient pas
toutes les instructions de l'instruction. La signature et les déclarations locales n'en ont
aucune ; {, }, else et les lignes vides peuvent porter l'adresse du bloc ou
du if qui les possède (l'entrée de la fonction pour les accolades les plus externes). L'indication de renommage sub_
n'est pas ajoutée dans ce mode. Hex-Rays peut afficher une très grande fonction
différemment d'un appel à l'autre, donc n'utilisez code et lines que de la même
réponse. Nexus prend en charge ce mode. Via le socket CLI, une grande
réponse est stockée dans le cache de réponses comme n'importe quelle autre (IDA_MCP_MAX_INLINE_BYTES).