Skip to main content
Glama
won0-kim

IDAMCP

by won0-kim
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python

IDAMCP

IDA Pro plugin that exposes IDA Python execution via MCP (Model Context Protocol) over SSE. This allows AI tools like Claude Code to interact with IDA Pro for reverse engineering tasks.

How It Works

IDAMCP runs an MCP server inside IDA Pro that provides an execute_script tool. AI clients send IDA Python code through MCP, which gets executed on IDA's main thread. Results (stdout, stderr, return values) are sent back to the client.

AI Client (Claude Code, etc.)
    │
    │  MCP over SSE
    ▼
IDAMCP Server (127.0.0.1:13337)
    │
    │  ida_kernwin.execute_sync
    ▼
IDA Pro Main Thread

Related MCP server: IDAssistMCP

Requirements

  • IDA Pro 9.0+

  • Python 3.12+

  • uv

Installation

git clone https://github.com/won0-kim/idamcp.git
cd idamcp
uv sync

Install the plugin into IDA's plugins directory:

python install.py

To specify a custom IDA installation path:

python install.py --ida-dir "C:\Path\To\IDA"

To uninstall:

python install.py --uninstall

Usage

  1. Open IDA Pro — the MCP server starts automatically on http://127.0.0.1:13337/mcp

  2. Toggle the server on/off with Ctrl+Shift+M

  3. Connect your MCP client to the server

MCP Client Configuration

Add to your MCP client config (e.g., .mcp.json):

{
  "mcpServers": {
    "idamcp": {
      "type": "http",
      "url": "http://127.0.0.1:13337/mcp"
    }
  }
}

execute_script Tool

The server exposes a single execute_script tool. Send IDA Python code as a string. Assign to __result__ to return a specific value.

# List first 5 functions
import idautils
__result__ = list(idautils.Functions())[:5]
# Get function name at address
import idc
__result__ = idc.get_func_name(0x401000)

Development

uv sync --all-extras
uv run pytest
uv run ruff check .
uv run ruff format .
uv run pyright

Project Structure

idamcp/
├── idamcp/
│   ├── __init__.py      # Package version
│   ├── bridge.py        # IDA main thread execution bridge
│   ├── plugin.py        # IDA plugin entry point
│   └── server.py        # FastMCP server with execute_script tool
├── tests/
│   ├── test_bridge.py
│   └── test_server.py
├── install.py           # Development plugin installer
├── idamcp_plugin.py     # Standalone plugin entry point
└── pyproject.toml

License

MIT

This server cannot be deployed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • IDAssistMCP

    symgraph
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables LLM clients like Claude to interact with IDA Pro for binary analysis, decompilation, cross-references, patching, and more via 41 MCP tools, 8 resources, and 7 guided prompts.
    51
    MIT

  • IX64MCP

    lowcort1sol
    A
    license
    Not graded
    quality
    D
    maintenance
    Connects AI agents to IDA Pro and x64dbg for unified static and dynamic reverse engineering, enabling coordinated analysis, debugging, and patch planning through a local MCP daemon.
    16
    MIT

  • IDA Script MCP

    SuZiXunYue
    A
    license
    A
    quality
    B
    maintenance
    Executes IDAPython scripts in IDA Pro through any MCP-compatible AI assistant, enabling AI-powered binary analysis with full access to IDA's API.
    5
    51
    MIT