IDA MCP Server

IDA MCP Server

By MxIris-Reverse-Engineering GitHub

A Model Context Protocol server for IDA

Overview

what is IDA MCP Server?

IDA MCP Server is a Model Context Protocol server designed for IDA interaction and automation, providing tools to read IDA databases via Large Language Models.

how to use IDA MCP Server?

To use IDA MCP Server, you can either run it using the uv tool or install it via pip. For uv, use uvx mcp-server-ida. For pip, install with pip install mcp-server-ida and run it using python -m mcp_server_ida.

key features of IDA MCP Server?

  • Facilitates interaction with IDA databases through Large Language Models.
  • Supports debugging with the MCP inspector.
  • Configurable for use with Claude Desktop.

use cases of IDA MCP Server?

  1. Automating data retrieval from IDA databases.
  2. Enhancing IDA workflows with AI-driven insights.
  3. Debugging and testing changes in local development environments.

FAQ from IDA MCP Server?

  • Is IDA MCP Server free to use?

Yes! IDA MCP Server is open-source and free to use.

  • What programming language is used for IDA MCP Server?

IDA MCP Server is developed in Python.

  • How can I debug issues with the server?

You can use the MCP inspector or check the logs for debugging.

Content

IDA MCP Server

NOTE

The idalib mode is under development, and it will not require installing the IDA plugin or running IDA (idalib is available from IDA Pro 9.0+).

Overview

A Model Context Protocol server for IDA interaction and automation. This server provides tools to read IDA database via Large Language Models.

Please note that mcp-server-ida is currently in early development. The functionality and available tools are subject to change and expansion as we continue to develop and improve the server.

Installation

When using uv no specific installation is needed. We will use uvx to directly run mcp-server-ida.

Using PIP

Alternatively you can install mcp-server-ida via pip:

pip install mcp-server-ida

After installation, you can run it as a script using:

python -m mcp_server_ida

IDA-Side

Copy repository/plugin/ida_mcp_server_plugin.py and repository/plugin/ida_mcp_server_plugin directory into IDAs plugin directory

Windows: %APPDATA%\Hex-Rays\IDA Pro\plugins

Linux/macOS: $HOME/.idapro/plugins eg: ~/.idapro/plugins

igors-tip-of-the-week-103-sharing-plugins-between-ida-installs

Configuration

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

Using uvx
"mcpServers": {
  "git": {
    "command": "uvx",
    "args": [
        "mcp-server-ida"
    ]
  }
}
Using pip installation
"mcpServers": {
  "git": {
    "command": "python",
    "args": [
        "-m", 
        "mcp_server_ida"
    ]
  }
}

Debugging

You can use the MCP inspector to debug the server. For uvx installations:

npx @modelcontextprotocol/inspector uvx mcp-server-ida

Or if you've installed the package in a specific directory or are developing on it:

cd path/to/mcp-server-ida/src
npx @modelcontextprotocol/inspector uv run mcp-server-ida

Running tail -n 20 -f ~/Library/Logs/Claude/mcp*.log will show the logs from the server and may help you debug any issues.

Development

If you are doing local development, there are two ways to test your changes:

  1. Run the MCP inspector to test your changes. See Debugging for run instructions.

  2. Test using the Claude desktop app. Add the following to your claude_desktop_config.json:

UVX

{
"mcpServers": {
  "git": {
    "command": "uv",
    "args": [ 
      "--directory",
      "/<path to mcp-server-ida>",
      "run",
      "mcp-server-ida"
    ]
  }
}

Alternatives

ida-pro-mcp

ida-mcp-server-plugin

mcp-server-idapro

pcm

Screenshots

Screenshot 1 Screenshot 2 Screenshot 3

No tools information available.
No content found.