idapin-mcp

IDA の idadbg PIN ツールをコンパイルし、IDA Pro に接続し、同じ pintool を あらゆる MCP 対応 AI (Grok、Claude Desktop、Cursor、VS Code、…) に IDA GUI を開かずに公開する Windows パイプラインです。

このリポジトリには 完全なプロジェクトソース が含まれています: Windows pintool (pintool/)、MCP サーバー (src/idapin_mcp/)、およびインストール/ビルドパイプライン (scripts/)。

PIN は実行中のプロセスを計測します。idadbg は IDA pintool プロトコル (v9) を使用します。MCP プロセスはそのプロトコルの TCP クライアントであるため、AI ツールは IDA GUI を必要としません。

Intel PIN (pin.exe) はここには 同梱されていません (Intel ライセンス)。scripts/setup.ps1 が PIN 3.31 MSVC キットをダウンロードします。

内容

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

要件 (Windows)

• Windows 10/11 x64

• Python 3.10+

• Visual Studio 2017 以降 MSVC x86/x64 を含む (2019、2022、2026 はいずれも動作します。ビルドスクリプトは最新のツールセットを選択します)

• Windows 10 SDK (VS とともにインストールされた任意の 10.0.*)

• IDA Pro 7.x/8.x/9.x オプション — GUI PIN トレーサーも必要な場合のみ

• Intel PIN 3.31 を取得するためのネットワーク接続が一度だけ必要です (pin-external-3.31-98869-…-msvc-windows.zip)

管理者権限は 不要 です。C:\pin に書き込めない場合は、-PinRoot "$env:LOCALAPPDATA\idapin-mcp\pin" を設定してください (PIN にはスペースを含まないパスの方が安全です)。

ワンコマンドセットアップ

リポジトリルートで PowerShell を実行:

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

このスクリプトは次の操作を実行します:

1. %LOCALAPPDATA%\idapin-mcp\venv を作成し、pip install -e . を実行

2. PIN 3.31 を C:\pin (または指定したパス) にダウンロード

3. pintool/ を PIN\source\tools\idapin にコピーし、VS プロジェクトを再ターゲットして、Win32 + x64 Release をビルド

4. 見つかったすべての IDA インストールの dbg_pin.cfg にパッチを適用

5. Grok、Claude Desktop、Cursor、VS Code のユーザー設定に MCP サーバーを登録

その後 AI クライアントを再起動 してください。

PIN のカスタム場所:

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

一括スクリプトの代わりにステップバイステップで実行: docs/windows-build.md。

MCP ツール (あらゆる AI 向け)

起動後、プロセスは PROCESS_STARTED の時点で 中断 されます。ブレークポイントを設定してから再開してください。

プロンプト例:

idapin MCP を使用: pin_launch を C:\Windows\System32\cmd.exe に対して、引数 /c echo hi で実行し、レジスタを読み取り、その後 pin_resume と pin_stop を実行します。

手動の MCP スニペット: configs/mcp.example.json。クライアント別の注意事項: docs/ai-clients.md。

IDA Pro (GUI トレーサー)

setup.ps1 が書き込む内容:

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

IDA 内で: デバッガ → デバッガの選択 → PIN tracer を選択し、F9 を押します。詳細: docs/ai-clients.md。

ヘッドレスの idalib は pin_user.dll を起動できません。そのため、この MCP は pintool と 直接 通信します。

ライセンス

ライセンスは分割されています。MCP サーバーは MIT ですが、pintool は MIT ではありません。

NOTICE を参照してください。pintool/ を MIT として再ライセンスしないでください。

pin.exe、PIN の zip、コンパイル済みの *.dll をコミットしないでください。

ブラウザから GitHub に公開する場合 (Git のインストール不要): docs/publish-github.md。