Skip to main content
Glama
Headless IDA MCP Server

Headless IDA MCP Server

by cnitlrt

Acknowledgments

This project builds upon the work of:

Headless IDA MCP Server

If you want to run the server directly as a cli app, rather than an IDA plugin interactively,you can chose it.

Project Description

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

Related MCP server: idalib-mcp-headless

Prerequisites

Installation

  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 .

Configuration

  1. Copy the example environment file:

    cp .env_example .env
  2. Configure the following environment variables in .env:

    • IDA_PATH: Path to IDA Pro's headless executable (idat), e.g., /home/ubuntu/idapro/idat

    • PORT: Port number for the MCP server, e.g., 8888

    • HOST: Host address for the MCP server, 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:

    Debug it:

    npx -y @modelcontextprotocol/inspector

    or

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      A headless IDA Pro MCP server that enables AI agents to automatically open, analyze, and query multiple binary files simultaneously without manual GUI interaction. It provides 36 tools for tasks like decompilation, disassembly, and cross-reference analysis through IDA's idalib library.
      163 PyPI
      14
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      A headless MCP server that manages multiple independent IDA Pro worker processes for reverse engineering, supporting database operations and debug tools.
      27
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Headless MCP server for IDA Pro enabling on-demand database loading and programmatic reverse engineering workflows via MCP tools.
      19
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      An MCP server that exposes IDA Pro's disassembler and Hex-Rays decompiler as tools and resources, enabling parallel binary analysis with multiple agents through a supervisor.
      18 PyPI
      10
      MIT