← all repositories
mrexodia/ida-pro-mcp

Vibe reversing: giving your IDA Pro disassembly an AI intern

An MCP bridge that lets LLM agents query, decompile, and annotate binaries directly inside IDA Pro so you can reverse by chatting instead of clicking.

10.6k stars Python Coding AssistantsAgents
ida-pro-mcp
Velocity · 7d
+54
★ / day
Trend
accelerating
star history

What it does

IDA Pro MCP is a protocol bridge that turns IDA Pro into an MCP server, letting language-model agents read decompilation, cross-references, types, and metadata from an open database. Instead of copy-pasting assembly into a chat window, the agent calls structured tools like lookup_funcs and int_convert to inspect the binary interactively. It supports both a headless idalib-mcp mode and a legacy GUI plugin, though the latter is on its way out.

The interesting bit

The headless supervisor keeps each database in a separate worker process and can dynamically open or close arbitrary files over the server’s lifetime. If a database is already loaded in a GUI IDA instance, the server routes requests there rather than spawning a duplicate worker; if that GUI disappears, it silently falls back to a headless worker. That makes it feel less like a bolt-on script and more like a shared backplane for AI-assisted reversing.

Key highlights

  • Broad client support: works with Claude, Cursor, VS Code, Codex, and many other MCP clients via stdio, SSE, or HTTP transports.
  • Structured MCP resources expose IDB metadata, segments, imports, exports, structs, and cross-references as browsable URLs like ida://idb/segments.
  • Session-aware multi-binary handling: open and switch between several databases via idalib_open and idalib_switch without restarting the server.
  • Optional --isolated-contexts prevents multiple AI agents from accidentally clobbering each other’s default database binding.
  • The README ships with battle-tested prompt templates to curb LLM hallucinations during decompilation and variable renaming.

Caveats

  • Requires a paid IDA Pro license (8.3+, version 9 recommended); IDA Free is explicitly unsupported.
  • The old GUI plugin is deprecated and slated for removal, so new users must adopt the headless idalib workflow.
  • The authors warn that LLMs still struggle with obfuscated code—control-flow flattening, string encryption, and import hashing need manual cleanup before the agent can reason accurately.

Verdict

This is for reverse engineers who already own IDA Pro and want to speed up grunt work—renaming functions, annotating types, and triaging crackmes—with an LLM copilot. If you rely on IDA Free or hope AI will unwrap heavily obfuscated malware without preprocessing, this bridge won’t help.

Frequently asked

What is mrexodia/ida-pro-mcp?
An MCP bridge that lets LLM agents query, decompile, and annotate binaries directly inside IDA Pro so you can reverse by chatting instead of clicking.
Is ida-pro-mcp open source?
Yes — mrexodia/ida-pro-mcp is open source, released under the MIT license.
What language is ida-pro-mcp written in?
mrexodia/ida-pro-mcp is primarily written in Python.
How popular is ida-pro-mcp?
mrexodia/ida-pro-mcp has 10.6k stars on GitHub and is currently accelerating.
Where can I find ida-pro-mcp?
mrexodia/ida-pro-mcp is on GitHub at https://github.com/mrexodia/ida-pro-mcp.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.