Headless IDA MCP Server

Expresiones de gratitud

Este proyecto se basa en el trabajo de:

• Código de herramientas adaptado de ida-pro-mcp por mrexodia
• Utiliza la biblioteca headless-ida de DennyDai

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.

Prerrequisitos

• Python 3.12 o superior
• IDA Pro con soporte sin cabeza (idat) https://github.com/DennyDai/headless-ida

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