Repolode
Submit
mrexodia

mrexodia/ida-pro-mcp

MCP server that connects IDA Pro to LLM clients so an AI assistant can decompile, annotate and rename binaries during reverse engineering.

View on GitHubWebsite
Stars
13,388
Forks
1,639
Open issues
56
Last commit
last month

What is it?

IDA Pro MCP is a Model Context Protocol server that exposes IDA Pro's analysis capabilities as tools that language models can call. Once connected from an MCP client such as Claude Code, Cursor or Codex, the model can list and look up functions, decompile and disassemble code, follow cross-references, read memory and types, and write back comments, names and type information into the IDA database.

The project runs either as an IDA plugin inside the GUI or as a headless server built on idalib, which is supervised by the idalib-mcp command. The headless mode can keep several databases open in separate worker processes, with each tool call naming the session it targets. An optional debugger extension adds tools for breakpoints, stepping, registers and memory access.

It requires IDA Pro 8.3 or later (IDA Free is not supported) and Python 3.11 or newer. The README notes that the Hex-Rays team now offers its own official IDA MCP server and recommends it over this project.

Key features

  • 01Exposes decompilation, disassembly and cross-reference lookups as MCP tools.
  • 02Writes comments, renames, and type declarations back into the IDA database.
  • 03Runs as an IDA GUI plugin or as a headless idalib server with multiple database sessions.
  • 04Includes an optional debugger extension for breakpoints, stepping and memory access.
  • 05Provides batch-oriented tools with paginated search results.

Use cases

  • Letting an LLM assistant annotate and rename functions while analyzing a binary.
  • Automating repetitive reverse engineering steps across several binaries with headless sessions.
  • Speeding up triage of crackmes or malware samples with AI-generated summaries of decompiled code.

Quick start

  1. 1

    Install Python 3.11+ and IDA Pro 8.3+ (IDA Free is not supported)

  2. 2

    Install the ida-pro-mcp package

    pip install https://github.com/mrexodia/ida-pro-mcp/archive/refs/heads/main.zip
  3. 3

    Configure the MCP servers and install the IDA plugin

    ida-pro-mcp --install
  4. 4

    Completely restart IDA and your MCP client

Things to know

  • IDA Free is not supported; it requires IDA Pro 8.3 or higher.
  • The README recommends the official Hex-Rays IDA MCP Server instead.
  • The GUI plugin installation method is no longer recommended and will eventually be deprecated.

In collections

Reverse engineering toolsMCP servers

Topics

#reverse-engineering#mcp#ida-pro#binary-analysis#llm-tools#decompiler#ai#aiagent#ida-plugin#mcp-server

FAQ

What is ida-pro-mcp?
MCP server that connects IDA Pro to LLM clients so an AI assistant can decompile, annotate and rename binaries during reverse engineering. IDA Pro MCP is a Model Context Protocol server that exposes IDA Pro's analysis capabilities as tools that language models can call. Once connected from an MCP client such as Claude Code, Cursor or Codex, the model can list and look up functions, decompile and disassemble code, follow cross-references, read memory and types, and write back comments, names and type information into the IDA database.
Is ida-pro-mcp free to use? What license does it have?
ida-pro-mcp is open source under the MIT license. Check the license terms before using it in commercial products.
Is ida-pro-mcp still maintained?
Updated within 6 months. The last commit to ida-pro-mcp was on Sep 26, 2026.
What can I use ida-pro-mcp for?
Letting an LLM assistant annotate and rename functions while analyzing a binary. Automating repetitive reverse engineering steps across several binaries with headless sessions. Speeding up triage of crackmes or malware samples with AI-generated summaries of decompiled code.
How do I install ida-pro-mcp?
Install Python 3.11+ and IDA Pro 8.3+ (IDA Free is not supported) Install the ida-pro-mcp package: pip install https://github.com/mrexodia/ida-pro-mcp/archive/refs/heads/main.zip Configure the MCP servers and install the IDA plugin: ida-pro-mcp --install Completely restart IDA and your MCP client
Where can I get ida-pro-mcp?
The source code and installation instructions are on GitHub: https://github.com/mrexodia/ida-pro-mcp

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects