Skip to main content
Glama
Headless IDA MCP Server

Headless IDA MCP Server

by cnitlrt

Expresiones de gratitud

Este proyecto se basa en el trabajo de:

Servidor IDA MCP sin cabeza

Si desea ejecutar el servidor directamente como una aplicación CLI, en lugar de un complemento IDA de forma interactiva, puede elegirlo.

Descripción del proyecto

Este proyecto utiliza el modo sin cabeza de IDA Pro para analizar archivos binarios y proporciona un conjunto de herramientas a través de MCP para administrar y manipular funciones, variables y más.

Related MCP server: idalib-mcp-headless

Prerrequisitos

Instalación

  1. Clonar el proyecto localmente:

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

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

Configuración

  1. Copie el archivo de entorno de ejemplo:

    cp .env_example .env
  2. Configure las siguientes variables de entorno en .env :

    • IDA_PATH : Ruta al ejecutable sin cabeza de IDA Pro (idat), por ejemplo, /home/ubuntu/idapro/idat

    • PORT : Número de puerto para el servidor MCP, por ejemplo, 8888

    • HOST : Dirección de host del servidor MCP, por ejemplo, 127.0.0.1

    • TRANSPORT : Modo de transporte MCP ( sse o stdio )

Uso

  1. Iniciar el servidor:

    uv run headless_ida_mcp_server
  2. Conectarse al servidor mediante un cliente MCP:

    Depurarlo:

    npx -y @modelcontextprotocol/inspector

    o

    {
    "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.
      32 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.
      28
      -
    • 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.
      68 PyPI
      12
      MIT