mcp protocol bridging with dual-process architecture
Exposes IDA Pro's reverse engineering API through the Model Context Protocol by implementing a proxy server that runs in a separate Python process from IDA, using zeromcp library for transport abstraction (stdio, HTTP, SSE modes). The proxy dispatches local MCP metadata requests directly while forwarding IDA-specific operations to the plugin's internal HTTP handler, enabling 30+ MCP clients (Claude Desktop, VS Code, Cursor, Windsurf) to communicate with IDA without blocking the UI thread.
Unique: Implements process isolation between MCP protocol handling and IDA's single-threaded runtime using a proxy + plugin architecture with zeromcp transport abstraction, enabling hot reload and supporting 30+ heterogeneous MCP clients without modifying IDA's core
vs alternatives: Unlike direct IDA Python plugins or REST wrappers, the dual-process MCP bridge allows LLMs to control IDA through a standardized protocol while preventing network requests from blocking the UI, and supports both interactive (GUI) and headless (idalib) modes from a single codebase
thread-safe ida api invocation via @idasync decorator chain
Enforces strict thread synchronization for all IDA API calls through a decorator pattern (@idasync) that queues requests and executes them on IDA's main thread, preventing race conditions and crashes from concurrent access to IDA's single-threaded database. The decorator system chains through the RPC layer, ensuring that all operations from the MCP proxy are serialized before reaching IDA's kernel.
Unique: Uses a decorator-based RPC system that chains @idasync decorators through the proxy layer to serialize all IDA API calls onto the main thread, with explicit @unsafe flags for privileged operations (debugging, code execution), rather than relying on locks or async/await primitives
vs alternatives: More robust than naive threading or lock-based approaches because it guarantees serialization at the architectural level, and more maintainable than manual queue management because the decorator pattern makes thread-safety requirements explicit in the code
resource-based mcp interface for binary metadata exposure
Exposes binary metadata (functions, strings, imports, types) as MCP resources that can be queried and subscribed to, rather than only through tool calls. Resources provide a read-only view of the binary's structure that LLMs can reference without invoking tools, enabling more efficient context management and reducing round-trips for metadata queries.
Unique: Implements MCP resources interface to expose binary metadata (functions, strings, imports) as queryable resources rather than only through tool calls, enabling LLMs to reference metadata in prompts without explicit tool invocations and reducing context management overhead
vs alternatives: More efficient than tool-only access for metadata because resources can be included in prompts directly, and more flexible than static exports because resources are dynamically generated from IDA's current analysis state
type-safe rpc layer with schema validation
Implements a type-safe RPC layer that validates all requests and responses against JSON schemas before forwarding to IDA, ensuring that LLM-generated tool calls conform to expected signatures and preventing crashes from malformed requests. The system uses Python type hints and Pydantic models to define tool schemas, which are exposed to MCP clients for validation and auto-completion.
Unique: Implements a type-safe RPC layer using Pydantic models and JSON schema validation that validates all LLM-generated tool calls before forwarding to IDA, preventing malformed requests from reaching IDA's API and providing schema information to MCP clients for validation
vs alternatives: More robust than unvalidated RPC because it catches type errors early before they reach IDA, and more developer-friendly than manual validation because Pydantic models provide both validation and auto-documentation
capability-based access control with @unsafe decorator gating
Implements fine-grained access control through decorator-based capability flags (@unsafe) that gate privileged operations (debugging, code execution, memory modification) and require explicit opt-in from MCP clients. The system tracks which capabilities are enabled per client and enforces them at the RPC boundary, preventing accidental privilege escalation.
Unique: Implements decorator-based capability gating (@unsafe flags) that requires explicit opt-in from MCP clients to access privileged operations (debugging, code execution, memory writes), providing defense-in-depth against accidental or malicious privilege escalation
vs alternatives: More explicit than implicit permission models because @unsafe decorators make privileged operations visible in code, and more flexible than role-based access control because capabilities can be enabled per-client without modifying server code
decompilation and disassembly retrieval with cross-reference analysis
Retrieves decompiled pseudocode, disassembly listings, and control flow graphs from IDA's analysis engine via MCP tools, supporting function-level and address-range queries. The system leverages IDA's built-in decompiler (Hex-Rays) and disassembly engine to generate human-readable code representations that LLMs can analyze, with cross-reference data (xrefs) showing function call graphs and data dependencies.
Unique: Exposes IDA's native decompiler and disassembly engine through MCP tools, allowing LLMs to request decompilation on-demand without parsing raw binary files, and includes cross-reference analysis that maps function call graphs and data dependencies discovered by IDA's static analysis
vs alternatives: More accurate than generic binary analysis tools (Ghidra, Radare2) because it uses IDA's proprietary decompiler and analysis engine, and more flexible than static decompilation because LLMs can iteratively request analysis of specific functions and follow xrefs interactively
binary metadata extraction (functions, strings, imports, types)
Extracts structured metadata from the loaded binary including function listings with entry points and sizes, string constants, imported symbols, and type information (function signatures, struct definitions). The system queries IDA's internal database (IDB) to enumerate all discovered functions, strings, and imports, returning them as JSON objects that LLMs can analyze for vulnerability patterns or functionality mapping.
Unique: Queries IDA's internal IDB database to extract all discovered metadata (functions, strings, imports, types) as structured JSON, leveraging IDA's analysis results rather than re-parsing the binary, enabling LLMs to reason about binary structure without loading the binary themselves
vs alternatives: More complete than static binary parsing tools because it uses IDA's sophisticated analysis engine to identify functions and resolve imports, and more efficient than re-analyzing the binary because it reuses IDA's cached analysis results
interactive binary modification (comments, patches, renaming, type declarations)
Allows LLMs to modify the binary analysis in IDA by adding comments, applying patches, renaming functions/variables, and declaring types. Modifications are persisted to the IDB file, enabling iterative analysis where LLMs can annotate their findings and the next analysis pass uses the updated metadata. The system enforces write safety through optional @unsafe decorators for sensitive operations.
Unique: Enables LLMs to persistently modify IDA's analysis database (IDB) with comments, patches, and type declarations, creating a feedback loop where subsequent analysis passes use the LLM's annotations, rather than treating analysis as read-only
vs alternatives: More powerful than read-only analysis tools because it allows LLMs to iteratively refine their understanding by annotating the binary, and more integrated than external patch tools because modifications are stored in IDA's native format and immediately visible in the GUI
+5 more capabilities