Headless IDA MCP Server

Integrations

  • Uses environment variables for configuration, allowing users to customize server settings such as IDA paths, binary paths, and network options through a .env file

  • Uses Git for project installation, requiring users to clone the repository to set up the server

  • References GitHub repositories for core components including the original tools code and headless-ida library that the project builds upon

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.

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"] } } }

-
security - not tested
F
license - not found
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

A server that provides remote binary analysis capabilities through IDA Pro's headless mode, allowing users to manage and manipulate functions, variables, and other binary elements via the Multi-Client Protocol.

  1. Headless IDA MCP Server
    1. Project Description
    2. Prerequisites
    3. Installation
    4. Configuration
    5. Usage

Related MCP Servers

  • -
    security
    F
    license
    -
    quality
    A Model Context Protocol server for reading and analyzing binary files, with initial support for Unreal Engine asset files (.uasset).
    Last updated -
    Python
    • Linux
    • Apple
  • A
    security
    F
    license
    A
    quality
    A server that provides advanced mathematical and financial calculation capabilities for AI code assistants, enabling them to perform complex calculations like symbolic calculus, numerical methods, and financial analysis without implementing algorithms directly.
    Last updated -
    18
    1
    JavaScript
  • A
    security
    A
    license
    A
    quality
    A Model Context Protocol server for IDA interaction and automation. This server provides tools to read IDA database via Large Language Models.
    Last updated -
    19
    415
    Python
    MIT License
    • Apple
  • A
    security
    A
    license
    A
    quality
    A Model Context Protocol server that enables AI assistants to interact with IDA Pro for reverse engineering and binary analysis tasks.
    Last updated -
    8
    14
    Python
    MIT License
    • Linux
    • Apple

View all related MCP servers

ID: eh9p5e0v47