Headless Ida MCP Server

🚀 Headless IDA MCP Server

This project leverages IDA Pro's headless mode to analyze binary files and provides a set of tools to manage and operate functions, variables, etc. through MCP.

🚀 Quick Start

If you want to run the server directly as a CLI application instead of interactively as an IDA plugin, you can choose this option.

✨ Features

The project uses IDA Pro's headless mode to analyze binary files and offers a suite of tools via MCP to manage and manipulate functions, variables, etc.

📦 Installation

Prerequisites

• Python 3.12 or higher
• IDA Pro executable with headless support (idat) https://github.com/DennyDai/headless-ida

Steps

1. Clone the project locally:

git clone https://github.com/cnitlrt/headless-ida-mcp-server.git 
cd headless-ida-mcp-server

2. Install dependencies:

uv python install 3.12
uv venv --python 3.12
uv pip install -e .

📚 Documentation

Configuration

1. Copy the example environment file:

cp .env_example .env

2. Configure the following environment variables in .env:

• IDA_PATH: Path to the IDA Pro headless executable, e.g., /home/ubuntu/idapro/idat
• PORT: MCP server port, e.g., 8888
• HOST: MCP server host address, e.g., 127.0.0.1
• TRANSPORT: MCP transport mode (sse or stdio)

Usage

1. Start the server:

uv run headless_ida_mcp_server

2. Connect to the server using an MCP client: For debugging:

npx -y @modelcontextprotocol/inspector

Or

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

📄 Acknowledgments

This project is built on the following works:

• Adapted tool code from ida-pro-mcp by mrexodia
• Utilized the headless-ida library by DennyDai