idapin-mcp

Canalización de Windows que compila la herramienta PIN idadbg de IDA, la conecta a IDA Pro y expone el mismo pintool a cualquier IA compatible con MCP (Grok, Claude Desktop, Cursor, VS Code, …) sin abrir la GUI de IDA.

Este repositorio incluye el código fuente completo del proyecto: el pintool de Windows (pintool/), el servidor MCP (src/idapin_mcp/) y la canalización de instalación/compilación (scripts/).

PIN instrumenta un proceso en vivo. idadbg habla el protocolo de pintool de IDA (v9). El proceso MCP es un cliente TCP de ese protocolo, por lo que las herramientas de IA no necesitan la GUI de IDA.

Intel PIN (pin.exe) no está incluido aquí (licencia de Intel). scripts/setup.ps1 descarga el kit MSVC de PIN 3.31.

Qué obtienes

AI client  --stdio MCP-->  python -m idapin_mcp  --TCP-->  pin.exe + idadbg*.dll  --instrument-->  target.exe
IDA Pro    --dbg_pin.cfg--> pin.exe + same DLLs   (optional GUI tracer)

Related MCP server: headless-re-mcp

Requisitos (Windows)

• Windows 10/11 x64

• Python 3.10+

• Visual Studio 2017 o posterior con MSVC x86/x64 (2019, 2022, 2026 funcionan; el script de compilación elige el conjunto de herramientas más reciente)

• Windows 10 SDK (cualquier 10.0.* instalado con VS)

• IDA Pro 7.x/8.x/9.x opcional, solo si además quieres el trazador PIN de la GUI

• Red una vez, para descargar Intel PIN 3.31 (pin-external-3.31-98869-…-msvc-windows.zip)

No se requieren permisos de administrador si no puedes escribir en C:\pin — establece -PinRoot "$env:LOCALAPPDATA\idapin-mcp\pin" (las rutas sin espacios son más seguras para PIN).

Configuración con un solo comando

En PowerShell, desde la raíz del repositorio:

Set-ExecutionPolicy -Scope Process Bypass
.\scripts\setup.ps1

Eso hará:

1. Crear %LOCALAPPDATA%\idapin-mcp\venv y pip install -e .

2. Descargar PIN 3.31 en C:\pin (o en la ruta que pases)

3. Copiar pintool/ en PIN\source\tools\idapin, reajustar el proyecto de VS y compilar Release para Win32 + x64

4. Parchear dbg_pin.cfg en todas las instalaciones de IDA que encuentre

5. Registrar el servidor MCP en las configuraciones de usuario de Grok, Claude Desktop, Cursor y VS Code

Después, reinicia el cliente de IA.

Ubicación personalizada de PIN:

.\scripts\setup.ps1 -PinRoot "$env:LOCALAPPDATA\idapin-mcp\pin"

Paso a paso en lugar del script general: docs/windows-build.md.

Herramientas MCP (para cualquier IA)

Después del lanzamiento, el proceso queda suspendido en PROCESS_STARTED. Establece puntos de interrupción y luego reanuda.

Ejemplo de prompt:

Usa idapin MCP: pin_launch sobre C:\Windows\System32\cmd.exe con argumentos /c echo hi, lee los registros y luego pin_resume y pin_stop.

Fragmento MCP manual: configs/mcp.example.json. Notas específicas por cliente: docs/ai-clients.md.

IDA Pro (trazador GUI)

setup.ps1 escribe:

PIN_PATH = "C:\\pin\\pin.exe";
PIN_TOOL_PATH = "C:\\pin\\source\\tools\\idapin";
PIN_TOOL_OPTIONS = 1

En IDA: Debugger → Select debugger → PIN tracer y luego F9. Detalles: docs/ai-clients.md.

idalib en modo headless no puede iniciar pin_user.dll; por eso este MCP habla con el pintool directamente.

Licencia

Licencias separadas. El servidor MCP es MIT; el pintool no.

Consulta NOTICE. No relicencies pintool/ como MIT.

No hagas commit de pin.exe, del ZIP de PIN ni de los *.dll compilados.

Publica en GitHub desde un navegador (sin instalar Git): docs/publish-github.md.