Cnitlrt Headless Ida MCP Server

🚀 Headless IDA MCP Server

A headless IDA Pro-based project that provides remote analysis and management capabilities through the Multi-Client Protocol (MCP).

🚀 Quick Start

The Headless IDA MCP Server uses the headless mode of IDA Pro to analyze binary files and offers a set of tools to manage and manipulate functions, variables, etc., via MCP.

✨ Features

• Utilize IDA Pro's headless mode for binary file analysis.
• Provide management and operation tools for functions and variables through MCP.

📦 Installation

Prerequisites

• Python 3.10 or higher.
• IDA Pro 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 venv 
   source .venv/bin/activate
   uv pip install .
   

📚 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 (idat), e.g., /home/ubuntu/idapro/idat.
   • BINARY_PATH: Path to the binary file for analysis, e.g., ./test/main.
   • 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:

   npx -y @modelcontextprotocol/inspector
   

📄 Acknowledgments

This project is built upon the following works:

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