Pocket Disasm

1つのMCPエンドポイント。多数の独立したIDALibセッション。

軽量でエージェントファーストの制御層。IDA Pro MCPツールセットを用いたヘッドレスバイナリ解析のためのものです。

[!IMPORTANT] Pocket Disasmは独立したオープンソースプロジェクトです。Hex-Raysとの提携、推奨、スポンサー、公式製品ではありません。 IDA ProおよびIDALibはHex-Raysの製品であり、個別に有効なインストールとライセンスが必要です。Pocket DisasmはIDA、IDALib、またはその他のHex-Raysソフトウェアを配布しません。

Pocket Disasmは1つの公開MCPルーターを実行し、バイナリごとに独自のIDALibワーカーを割り当てます。コーディングエージェントは、ファイルごとに個別の対話型IDAウィンドウを起動することなく、解析セッションの作成、選択、検査、保存、終了を行うことができます。

このプロジェクトは、コアのMCP解析実装およびツールカタログとして、mrexodia/ida-pro-mcpの固定リビジョンを使用しています。Pocket Disasmは、その上流プロジェクトを基に、統一マルチセッションルーター、プロセス分離、エージェント統合、診断、ターミナルコントロールセンターを構築しています。

インストール

PowerShellで1つのコマンドを実行します:

irm https://raw.githubusercontent.com/whoisqwerz/pocket_disasm/main/install.ps1 | iex

その後、新しいターミナルを開いて実行します:

pocket

インストーラーは %LOCALAPPDATA%\PocketDisasm 以下に独立したPython環境を作成し、固定された依存関係をインストールし、ユーザーの PATH に pocket コマンドを追加し、ターミナルコントロールセンターを開きます。

Pocket Disasm を選ぶ理由

• 1つのエンドポイント — エージェントは単一のストリーミング可能なHTTP MCPエンドポイントに接続します。
• 真のマルチセッション解析 — 各バイナリは独立したIDALibプロセスで実行されます。
• 並列エージェントワークフロー — 複数のエージェントが同時に異なるバイナリを解析できます。
• IDA Pro MCP互換性 — 解析呼び出しは固定された ida-pro-mcp ツールカタログにルーティングされます。
• エージェント管理セッション — LLMはMCPツールを介してバイナリを開き切り替えることができます。
• 組み込み統合 — TUIからCodex、Claude Code、Cursor、VS Code、Windsurfを設定できます。
• IDA GUI自動化不要 — ワーカーはIDALibを直接使用し、対話型IDAウィンドウは不要です。
• 永続的な診断 — ルーター、ワーカー、インストーラー、アップデート、ライフサイクルイベントが記録されます。
• 自己更新サポート — TUIは起動時にGitHubで新しいバージョンを確認し、その場で更新を提供します。

クイックスタート

1. pocket を実行します。
2. Configure IDA を選択し、idalib.dll を含むディレクトリを指定します。
3. Connect a coding agent を選択し、グローバルまたはプロジェクトスコープを指定します。
4. 必要に応じて Concurrent IDALib sessions を調整します。
5. Start MCP router を選択します。
6. 設定したコーディングエージェントを再起動またはリロードします。

デフォルトのエンドポイントは次のとおりです:

http://127.0.0.1:13339/mcp

ポートはTUIから変更できます。Pocket Disasmは以前に登録したすべてのMCP設定ファイルを更新し、必要に応じてルーターを再起動します。

エージェントのワークフロー

エージェントはバイナリごとに専用のMCPサーバーを必要としません。共有エンドポイントを通じてセッションを作成しルーティングします:

idb_open(input_path="C:\\samples\\first.exe", session_id="first", wait=true)
idb_open(input_path="C:\\samples\\second.dll", session_id="second", wait=true)

decompile(addr="main", database="first")
survey_binary(database="second")

選択は現在のMCPクライアントにスコープすることもできます:

idb_select(database="first")
decompile(addr="main")

これにより、1つのモデルが複数のバイナリを管理したり、複数のエージェントが同じルーターを通じて、選択されたデータベースを共有せずに作業したりできます。

アーキテクチャ

flowchart LR
    A1["Coding agent A"] --> MCP["Pocket Disasm MCP<br/>127.0.0.1:13339/mcp"]
    A2["Coding agent B"] --> MCP
    A3["Coding agent N"] --> MCP
    MCP --> S["Multi-session supervisor"]
    S --> W1["IDALib worker<br/>binary A"]
    S --> W2["IDALib worker<br/>binary B"]
    S --> WN["IDALib worker<br/>binary N"]

アクティブなセッションはそれぞれ独自のプロセス、内部ポート、独立した解析ワークスペース、IDAデータベース、ワーカーログを持ちます。設定可能なワーカー数の上限により無制限なプロセス生成を防ぎます。デフォルトは8で、TUIでは1から128の値を受け付けます。

セッション管理ツール

Pocket Disasmは通常のIDA MCPカタログに以下のツールを追加します:

survey_binary、lookup_funcs、func_query、find_bytes、decompile などの通常の解析ツールは、オプションの database 引数を受け付けます。省略した場合、Pocket DisasmはそのMCPクライアントによって選択されたセッションを使用します。

コーディングエージェント統合

TUIは既存の設定ファイルに pocket-disasm MCPエントリのみをマージします。ファイル全体を置き換えることはありません。

同様の操作はCLIからも利用可能です:

pocket integrate codex claude cursor --scope global
pocket integrate claude cursor vscode --scope project --project-dir .

CLI

TUIは通常のインストールと制御をカバーします。CLIは自動化と診断のために引き続き使用できます:

すべてのオプションについては pocket <command> --help を実行してください。

設定とログ

Pocket Disasmはユーザー状態を以下の場所に保存します:

%LOCALAPPDATA%\PocketDisasm

重要なファイルは次のとおりです:

TUIで Inspect logs を選択するか、以下を実行します:

pocket logs

更新

TUIは起動時に一度新しいバージョンを確認します。更新が利用可能な場合、アクションリストに Update Pocket Disasm が表示されます。アップデーターは設定を保持し、独立環境を更新し、TUIを再起動し、以前実行中だった場合はルーターをオンラインに戻します。

要件

• Windows 10 または Windows 11。
• Python 3.11 以上。インストーラーは winget を使用してPython 3.12をインストールできます。
• IDALibを提供する、個別にインストールおよびライセンスされたIDAバージョン。
• インストール時、エージェントの依存関係設定時、更新確認時にネットワークアクセスが必要です。

Pocket DisasmにはIDA、IDALib、IDAライセンスは含まれません。これは独立したプロジェクトであり、Hex-Raysとの提携や推奨はありません。

アンインストール

$script = irm https://raw.githubusercontent.com/whoisqwerz/pocket_disasm/main/install.ps1
& ([scriptblock]::Create($script)) -Uninstall

エージェントのMCPエントリは意図的に自動削除されません。これにより、アンインストール中に関係のない設定が書き換えられることはありません。不要になった場合は、対応するエージェント設定ファイルから削除できます。

謝辞

• mrexodia/ida-pro-mcp — mrexodiaによって作成・保守されている、Pocket Disasmが使用するコアIDA MCPサーバーと解析ツールを提供します。上流プロジェクトはMITライセンスの下で配布されています。
• Hex-Rays — IDAとIDALibを提供します。これらはユーザーが個別にインストールおよびライセンスする必要があります。

ライセンス

Pocket Disasmは MIT License の下でリリースされています。