ida -rs
Headless IDA Pro MCP Server
claude mcp add --transport stdio blacktop-ida-mcp-rs ida-mcp
How to use
ida-mcp-rs provides a headless IDA Pro MCP server that lets your AI agents interact with IDA Pro capabilities remotely. The server exposes a catalog of analysis tools and actions (such as opening binaries, listing functions, disassembling by name, and decompiling with Hex-Rays when available) that you can invoke via the MCP protocol. The README demonstrates commands like open_idb, tool_catalog, list_functions, disasm_by_name, and decompile, enabling automated workflows for binary reverse engineering, scriptable analysis, and integration with agents such as Claude, Codex, Gemini, or Cursor. To start, ensure the ida-mcp server is reachable using the configured mcpServers entry, and then configure your agent to point at the server, e.g., by adding an mcp.json entry for ida as shown in the repository documentation. The server will mirror IDA Pro versions (v9.3.x or v9.2.x) and will emit a clear startup error if there is a version mismatch, helping you diagnose compatibility quickly.
How to install
Prerequisites:
- A compatible IDA Pro installation (ID A Pro 9.2+ with a valid license)
- A host machine compatible with the target OS (macOS, Linux, or Windows)
- Optional: development tools if you plan to build from source
Installation options:
- macOS (via Homebrew)
brew install blacktop/tap/ida-mcp # LATEST (IDA 9.3)
brew install blacktop/tap/ida-mcp@9.2 # IDA 9.2
- Linux / Windows
- Download the release matching your IDA version from GitHub Releases: https://github.com/blacktop/ida-mcp-rs/releases
- Extract and place the ida-mcp executable in your PATH or a suitable location
- Build from source
# Prerequisites: Rust toolchain, IDA Pro installed
git clone https://github.com/blacktop/ida-mcp-rs.git
cd ida-mcp-rs
cargo build --release
Configure your agent (optional) to point to the server once installed. The README notes that the server automatically detects standard IDA library paths. If you encounter library loading issues, ensure IDA libraries are discoverable through IDA’s usual environment variables or RPATH settings.
Additional notes
Notes and tips:
- The server expects a valid IDA Pro installation. If IDA is in a non-standard location, you may need to set IDADIR (Linux/macOS) or adjust DYLD_LIBRARY_PATH (macOS) to allow dynamic linking to libida.*.dylib/so.
- The IDA Pro version must match the release you installed (v9.3.x for IDA 9.3, v9.2.x for IDA 9.2); a mismatch will be reported at startup.
- For macOS, if you see Library not loaded: @rpath/libida.dylib, configure DYLD_LIBRARY_PATH to the IDA binaries directory.
- The server exposes a rich tool catalog by default; use tool_catalog or tool_help to discover capabilities programmatically.
- This is a Rust-based MCP server; there is no npm package name to install. The npm_package field is null.
Related MCP Servers
mcp-discovery
A command-line tool written in Rust for discovering and documenting MCP Server capabilities.
rust -schema
A type-safe implementation of the official Model Context Protocol (MCP) schema in Rust.
turbomcp
A full featured, enterprise grade rust MCP SDK
turbovault
MCP server that transforms your Obsidian vault into an intelligent knowledge system
spec-kit
MCP server enabling AI assistants to use GitHub's spec-kit methodology
mcp-loxone
An opinionated Model Context Protocol (MCP) server for controlling Loxone home automation systems.