IDAssistMCP

Serveur MCP (Model Context Protocol) autonome pour IDA Pro 9.x qui expose les capacités d'analyse d'IDA aux clients LLM comme Claude Desktop.

Fonctionnalités

• 41 outils MCP couvrant l'analyse binaire, la décompilation, les références croisées, la gestion des symboles, le système de types, la navigation, le patching, l'exportation, etc.
• 6 outils consolidés avec paramètres action/format/direction pour les commentaires, variables, types, xrefs, signets et code
• 8 ressources MCP pour les métadonnées binaires consultables (tri, fonctions, importations, exportations, chaînes, informations, segments, sections)
• 7 invites guidées pour les workflows courants de rétro-ingénierie (analyse de fonction, identification de vulnérabilité, documentation, traçage de flux de données, comparaison de fonctions, récupération de structure, analyse de protocole réseau)
• Transports SSE et HTTP streamable via le serveur ASGI Hypercorn
• Modifications IDB thread-safe via le wrapper execute_on_main_thread()
• Cache d'analyse LRU pour les opérations coûteuses comme la décompilation
• Gestionnaire de tâches asynchrones pour les opérations longues
• Configuration Pydantic avec prise en charge des variables d'environnement (préfixe IDASSISTMCP_)

Installation

Prérequis

• IDA Pro 9.x avec Python 3.10+
• Décompilateur Hex-Rays (optionnel, pour les outils de décompilation)

Option 1 : Gestionnaire de plugins IDA (recommandé)

hcli plugin install idassistmcp

Ceci installe automatiquement le plugin et ses dépendances Python.

Option 2 : Installation manuelle (à partir de l'archive de version)

Téléchargez la dernière archive zip depuis GitHub Releases et extrayez-la dans votre répertoire de plugins IDA :

Linux / macOS :

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

Windows : Extrayez le zip dans %APPDATA%\Hex-Rays\IDA Pro\plugins\.

Installez ensuite les dépendances en utilisant le Python intégré d'IDA (pas celui de votre système) :

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"

Remplacez <IDA_INSTALL_DIR> par le chemin d'installation de votre IDA Pro.

Astuce : Vous pouvez également utiliser la variable d'environnement IDAUSR pour spécifier un répertoire de plugins personnalisé.

Utilisation

Démarrage du serveur

1. Ouvrez un binaire dans IDA Pro
2. Appuyez sur Ctrl+Shift+M ou allez dans Edit > Plugins > IDAssistMCP
3. L'URL du serveur MCP sera affichée dans la fenêtre de sortie d'IDA
4. Appuyez à nouveau sur Ctrl+Shift+M pour arrêter le serveur

Configuration de Claude Desktop

Ajoutez à votre claude_desktop_config.json :

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

Variables d'environnement

Configurez via des variables d'environnement avec le préfixe IDASSISTMCP_ :

Variable	Valeur par défaut	Description
IDASSISTMCP_SERVER__HOST	localhost	Adresse de liaison du serveur
IDASSISTMCP_SERVER__PORT	9080	Port du serveur
IDASSISTMCP_SERVER__TRANSPORT	streamablehttp	Type de transport (sse ou streamablehttp)
IDASSISTMCP_DEBUG	false	Activer le mode débogage
IDASSISTMCP_LOG_LEVEL	INFO	Niveau de journalisation

Référence des outils

Gestion des binaires (2)

Outil	Description
list_binaries	Liste le binaire actuellement chargé
get_binary_info	Informations détaillées du binaire (architecture, hachages, segments)

Analyse de code (4)

Outil	Description
get_code	Obtenir le code d'une fonction — format : 'decompile' (pseudo-C) ou 'disasm' (assembleur)
analyze_function	Analyse complète : métadonnées, CFG, appelants/appelés, décompilation
get_basic_blocks	Blocs de base du CFG avec successeurs/prédécesseurs
get_function_stack_layout	Disposition de la pile (variables locales, arguments, registres sauvegardés)

Références croisées (1 consolidé)

Outil	Actions	Description
xrefs	direction: to/from/both, include_calls: bool	Xrefs et appelants/appelés optionnels pour une adresse

Commentaires (1 consolidé)

Outil	Actions	Description
comments	action: get, set, list, remove	Gérer les commentaires (normaux, répétables, de fonction)

Variables (1 consolidé)

Outil	Actions	Description
variables	action: list, rename	Lister les variables locales, ou renommer des variables locales/globales avec scope: auto, local, global

Types (2 — 1 consolidé + 1 autonome)

Outil	Actions / Description
types	action: list, set, create_struct, create_enum — gérer les types IDB
get_classes	Liste les types struct/class de la bibliothèque de types

Découverte de fonctions (5)

Outil	Description
get_functions	Toutes les fonctions avec filtrage et pagination
search_functions_by_name	Recherche par motif de nom et filtres de taille
get_function_by_name	Recherche exacte par nom
get_function_by_address	Recherche par adresse
get_function_statistics	Statistiques agrégées (nombres, tailles, top 10)

Gestion des symboles (2)

Outil	Description
rename_symbol	Renommer n'importe quel symbole (fonction ou donnée)
batch_rename	Renommer plusieurs symboles en lot

Informations binaires (5)

Outil	Description
get_imports	Table d'importations groupée par module
get_exports	Table d'exportations
get_strings	Table de chaînes avec pagination
get_segments	Segments mémoire avec permissions
get_entry_points	Tous les points d'entrée du binaire

Analyse de données (6)

Outil	Description
read_memory	Lire les octets bruts à une adresse
get_data_at	Obtenir des données typées à une adresse
search_bytes	Recherche de motif d'octets binaires
search_strings	Recherche de chaînes avec pagination
create_data_var	Définir une variable de donnée à une adresse (byte/word/dword/qword/float/ascii/type C)
get_data_vars	Lister les variables de données définies (éléments non-code)

Patching (3)

Outil	Description
patch_bytes	Pâcher des octets bruts dans l'IDB
assemble_code	Assembler du texte d'instruction à une adresse et éventuellement le patcher
export_program	Exporter le binaire patché ou la base de données IDA sur le disque

Navigation (4)

Outil	Description
navigate_to	Déplacer le curseur IDA vers une adresse
bookmarks	Gestion consolidée des signets — actions : list, set, remove
get_current_address	Obtenir l'adresse et le contexte à la position du curseur
get_current_function	Obtenir les informations de la fonction à la position du curseur

Gestion des tâches (4)

Outil	Description
start_task	Démarrer une tâche asynchrone en arrière-plan
get_task_status	Vérifier la progression d'une tâche
cancel_task	Annuler une tâche en cours
list_tasks	Lister toutes les tâches asynchrones

Structure du projet