mcpField
H
headless-ida-mcp-server

headless-ida-mcp-server

Local
github.com/cnitlrtSecurity45Updated 82w ago
Repository

About headless-ida-mcp-server

headless-ida-mcp-server is an MCP server that runs IDA Pro in headless mode (idat) as a command line application instead of an interactive IDA plugin. It is aimed at users who analyze binary files and provides tools for managing and manipulating functions, variables and more.

Key features

  1. 01Runs as a command line app without an IDA plugin
  2. 02Analyzes binary files using IDA Pro headless mode
  3. 03Provides MCP tools for functions and variables
  4. 04Supports sse and stdio transport modes

Use cases

  1. 01Automating reverse engineering of binary files
  2. 02Calling IDA analysis capabilities from MCP clients
  3. 03Running IDA analysis on servers without a GUI

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

README image

README image

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.