hexrayssa/ida-mcp

541 stars 0 forks Quality 57 Trend 57

Official Hex-Rays IDA MCP Server.

Overview

Official Hex-Rays IDA MCP Server, see the announcement blog post for more information. - Installed in your PATH - Git - uv - IDA 9.4 or higher with idalib and Python 3.11+ - We recommend disabling other IDA MCP servers to reduce agent confusion Install the Hex-Rays IDA MCP using hcli: This will install the GUI plugin and interactively offer you to install the supported agent plugins. To support IDA GUI instances when using IDA MCP, install the plugin: Note: Without the GUI plugin, IDA MCP will still work headlessly. Configure a regular stdio MCP server in your MCP JSON configuration: uvx resolves the latest stable ida-mcp release from PyPI, so this configuration does not need to be updated for each release.

README

Hex-Rays IDA MCP

Official Hex-Rays IDA MCP Server, see the announcement blog post for more information.

Installation

Requirements

Installed in your PATH
- Git
- uv
IDA 9.4 or higher with idalib and Python 3.11+
We recommend disabling other IDA MCP servers to reduce agent confusion

Automatic installation

Install the Hex-Rays IDA MCP using hcli:

uvx ida-hcli mcp install
# or if you have hcli installed:
hcli mcp install

This will install the GUI plugin and interactively offer you to install the supported agent plugins.

Manual installation

CLI

# MCP server over standard input/output
uvx ida-mcp stdio --agent=my-agent

# MCP server over Streamable HTTP
uvx ida-mcp http --host 127.0.0.1 --port 8737

# Inspect session log
uvx ida-mcp dashboard --open

# Export session logs for troubleshooting
uvx ida-mcp logs

Usage

Start your agent harness and ask it something like:

Reverse /path/to/sample.elf for me in IDA

To test the GUI integration, open something in IDA and ask your harness:

What do I have open in the IDA GUI?

Developers: IDA Nexus

The IDA MCP project is built on IDA Nexus, which allows multiple clients to seamlessly share and operate on IDA databases.

You can build your own tools on top of the ida-nexus library, see the documentation for more information.

View this README on GitHub

Install

uvx --exclude-newer=1s ida-mcp stdio --agent=my-agent

Configuration

{
  "mcpServers": {
    "ida": {
      "command": "uvx",
      "args": [
        "--exclude-newer=1s",
        "ida-mcp",
        "stdio",
        "--agent=my-agent"
      ]
    }
  }
}