idapin-mcp

Windows-Pipeline, die IDAs idadbg-PIN-Tool kompiliert, es mit IDA Pro verbindet und dasselbe Pintool jedem MCP-fähigen KI-Tool (Grok, Claude Desktop, Cursor, VS Code, …) ohne die IDA-GUI zu öffnen bereitstellt.

Dieses Repository enthält den vollständigen Projektquellcode: das Windows-Pintool (pintool/), den MCP-Server (src/idapin_mcp/) und die Installations-/Build-Pipeline (scripts/).

PIN instrumentiert einen laufenden Prozess. idadbg spricht das IDA-Pintool-Protokoll (v9). Der MCP-Prozess ist ein TCP-Client für dieses Protokoll, sodass KI-Tools die IDA-GUI nicht benötigen.

Intel PIN (pin.exe) ist hier nicht enthalten (Intel-Lizenz). scripts/setup.ps1 lädt das PIN-3.31-MSVC-Kit herunter.

Was Sie bekommen

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

Voraussetzungen (Windows)

• Windows 10/11 x64

• Python 3.10+

• Visual Studio 2017 oder neuer mit MSVC x86/x64 (2019, 2022, 2026 funktionieren alle; das Build-Skript wählt das neueste Toolset)

• Windows 10 SDK (eine beliebige mit VS installierte Version 10.0.*)

• IDA Pro 7.x/8.x/9.x optional, nur wenn Sie auch den GUI-PIN-Tracer möchten

• Einmal Netzwerkzugriff, um Intel PIN 3.31 herunterzuladen (pin-external-3.31-98869-…-msvc-windows.zip)

Administratorrechte sind nicht erforderlich, wenn Sie nicht in C:\pin schreiben können — setzen Sie -PinRoot "$env:LOCALAPPDATA\idapin-mcp\pin" (Pfade ohne Leerzeichen sind für PIN sicherer).

Setup mit einem Befehl

In PowerShell aus dem Repository-Stammverzeichnis:

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

Das bewirkt Folgendes:

1. Erstellt %LOCALAPPDATA%\idapin-mcp\venv und führt pip install -e . aus.

2. Lädt PIN 3.31 nach C:\pin herunter (oder in den übergebenen Pfad).

3. Kopiert pintool/ in PIN\source\tools\idapin, richtet das VS-Projekt neu aus und baut Win32 + x64 Release.

4. Patcht dbg_pin.cfg in jeder gefundenen IDA-Installation.

5. Registriert den MCP-Server in den Benutzerkonfigurationen von Grok, Claude Desktop, Cursor und VS Code.

Starten Sie dann den KI-Client neu.

Benutzerdefinierter PIN-Speicherort:

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

Schritt-für-Schritt-Anleitung statt des Sammelskripts: docs/windows-build.md.

MCP-Tools (für jedes KI-Tool)

Nach dem Start ist der Prozess bei PROCESS_STARTED angehalten. Setzen Sie Haltepunkte und setzen Sie dann fort.

Verwenden Sie idapin MCP: pin_launch auf C:\Windows\System32\cmd.exe mit den Argumenten /c echo hi, lesen Sie die Register, dann pin_resume und pin_stop.

Manuelles MCP-Snippet: configs/mcp.example.json. Clientspezifische Hinweise: docs/ai-clients.md.

IDA Pro (GUI-Tracer)

setup.ps1 schreibt:

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

In IDA: Debugger → Select debugger → PIN tracer, dann F9. Details: docs/ai-clients.md.

Das Headless-idalib kann pin_user.dll nicht starten; deshalb spricht dieser MCP direkt mit dem Pintool.

Lizenz

Geteilte Lizenzierung. Der MCP-Server ist MIT-lizenziert; das Pintool nicht.

Siehe NOTICE. Lizenzieren Sie pintool/ nicht als MIT neu.

Committen Sie pin.exe, das PIN-Zip oder kompilierte *.dll-Dateien nicht.

Von einem Browser aus auf GitHub veröffentlichen (ohne Git-Installation): docs/publish-github.md.