Get the FREE Ultimate OpenClaw Setup Guide →

ida -rs

Headless IDA Pro MCP Server

Installation
Run this command in your terminal to add the MCP server to Claude Code.
Run in terminal:
Command
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:

  1. macOS (via Homebrew)
brew install blacktop/tap/ida-mcp        # LATEST (IDA 9.3)
brew install blacktop/tap/ida-mcp@9.2    # IDA 9.2
  1. Linux / Windows
  1. 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

Sponsor this space

Reach thousands of developers