IDAssistMCP

[!IMPORTANT] アーカイブ予定: IDA Pro がネイティブの MCP サーバーを同梱するようになるため、IDAssistMCP はアーカイブされる予定です。ネイティブサポートにより、別個の MCP 統合を維持する必要がなくなり、IDA Pro 本体と整合性が保たれます。インストールされているバージョンで利用可能になったら、IDA Pro のネイティブ MCP サーバーをご使用ください。このリポジトリは参照用として引き続き利用可能です。

IDA Pro 9.x 向けのスタンドアロン MCP (Model Context Protocol) サーバープラグインで、IDA の解析機能を Claude Desktop などの LLM クライアントに公開します。

機能

• 41 個の MCP ツール — バイナリ解析、逆コンパイル、クロスリファレンス、シンボル管理、型システム、ナビゲーション、パッチ適用、エクスポートなどをカバー
• 6 個の統合ツール — コメント、変数、型、xref、ブックマーク、コード向けの action/format/direction パラメータ付き
• 8 個の MCP リソース — 閲覧可能なバイナリメタデータ (トリアージ、関数、インポート、エクスポート、文字列、情報、セグメント、セクション)
• 7 個のガイド付きプロンプト — 一般的なリバースエンジニアリングワークフロー向け (関数解析、脆弱性の特定、ドキュメント作成、データフローの追跡、関数比較、構造体の復元、ネットワークプロトコル解析)
• SSE および Streamable HTTP トランスポート — Hypercorn ASGI サーバー経由
• スレッドセーフな IDB 変更 — execute_on_main_thread() ラッパー経由
• LRU 解析キャッシュ — 逆コンパイルなどの高コストな操作向け
• 非同期タスクマネージャー — 長時間実行される操作向け
• Pydantic 設定 — 環境変数サポート付き (IDASSISTMCP_ プレフィックス)

インストール

前提条件

• IDA Pro 9.x (Python 3.10 以上)
• Hex-Rays 逆コンパイラ (任意、逆コンパイルツール用)

オプション 1: IDA Plugin Manager (推奨)

hcli plugin install idassistmcp

これにより、プラグインとその Python 依存関係が自動的にインストールされます。

オプション 2: 手動インストール (リリース tarball から)

GitHub Releases から最新のリリース zip をダウンロードし、IDA の plugins ディレクトリに展開します:

Linux / macOS:

unzip IDAssistMCP-*.zip -d ~/.idapro/plugins/

Windows: zip を %APPDATA%\Hex-Rays\IDA Pro\plugins\ に展開します。

次に、IDA に同梱された Python (システムの Python ではない) を使って依存関係をインストールします:

Linux / macOS:

<IDA_INSTALL_DIR>/python3/bin/pip3 install -r ~/.idapro/plugins/IDAssistMCP/requirements.txt

Windows:

"<IDA_INSTALL_DIR>\python3\python.exe" -m pip install -r "%APPDATA%\Hex-Rays\IDA Pro\plugins\IDAssistMCP\requirements.txt"

<IDA_INSTALL_DIR> はご自身の IDA Pro インストールパスに置き換えてください。

ヒント: IDAUSR 環境変数を使ってカスタムの plugins ディレクトリを指定することもできます。

使用方法

サーバーの起動

1. IDA Pro でバイナリを開く
2. Ctrl+Shift+M を押すか、Edit > Plugins > IDAssistMCP に移動
3. MCP サーバーの URL が IDA の出力ウィンドウに表示されます
4. 再度 Ctrl+Shift+M を押すとサーバーが停止します

Claude Desktop の設定

Claude Desktop の claude_desktop_config.json に追加します:

{
  "mcpServers": {
    "idassistmcp": {
      "url": "http://localhost:9080/mcp"
    }
  }
}

環境変数

IDASSISTMCP_ プレフィックス付きの環境変数で設定します:

Variable	Default	Description
IDASSISTMCP_SERVER__HOST	localhost	サーバーのバインドアドレス
IDASSISTMCP_SERVER__PORT	9080	サーバーポート
IDASSISTMCP_SERVER__TRANSPORT	streamablehttp	トランスポート種別 (sse または streamablehttp)
IDASSISTMCP_DEBUG	false	デバッグモードを有効化
IDASSISTMCP_LOG_LEVEL	INFO	ログレベル

ツールリファレンス

バイナリ管理 (2)

Tool	Description
list_binaries	現在ロードされているバイナリを一覧表示
get_binary_info	詳細なバイナリメタデータ (アーキテクチャ、ハッシュ、セグメント)

コード解析 (4)

Tool	Description
get_code	関数コードを取得 — format: 'decompile' (疑似 C) または 'disasm' (アセンブリ)
analyze_function	包括的な解析: メタデータ、CFG、呼び出し元/呼び出し先、逆コンパイル
get_basic_blocks	後続/先行ブロック付きの CFG 基本ブロック
get_function_stack_layout	スタックフレームレイアウト (ローカル、引数、保存レジスタ)

クロスリファレンス (1 統合)

Tool	Actions	Description
xrefs	direction: to/from/both, include_calls: bool	アドレスへの xref と任意の呼び出し元/呼び出し先

コメント (1 統合)

Tool	Actions	Description
comments	action: get, set, list, remove	コメント (通常、繰り返し可能、関数) を管理

変数 (1 統合)

Tool	Actions	Description
variables	action: list, rename	ローカルを一覧表示、または scope: auto、local、global でローカル/グローバル変数をリネーム

型 (2 — 1 統合 + 1 スタンドアロン)

Tool	Actions / Description
types	action: list, set, create_struct, create_enum — IDB の型を管理
get_classes	型ライブラリから構造体/クラス型を一覧表示

関数の検出 (5)

Tool	Description
get_functions	フィルタリングとページネーション付きの全関数
search_functions_by_name	名前パターンとサイズフィルタで検索
get_function_by_name	完全一致の名前検索
get_function_by_address	アドレス検索
get_function_statistics	集計統計 (件数、サイズ、トップ 10)

シンボル管理 (2)

Tool	Description
rename_symbol	任意のシンボル (関数またはデータ) をリネーム
batch_rename	複数のシンボルを一括リネーム

バイナリ情報 (5)

Tool	Description
get_imports	モジュール別にグループ化されたインポートテーブル
get_exports	エクスポートテーブル
get_strings	ページネーション付きの文字列テーブル
get_segments	パーミッション付きのメモリセグメント
get_entry_points	すべてのバイナリエントリポイント

データ解析 (6)

Tool	Description
read_memory	アドレスにある生バイトを読み取り
get_data_at	アドレスにある型付きデータを取得
search_bytes	バイナリのバイトパターン検索
search_strings	ページネーション付きの文字列検索
create_data_var	アドレスにデータ変数を定義 (byte/word/dword/qword/float/ascii/C 型)
get_data_vars	定義済みデータ変数 (非コード項目) を一覧表示

パッチ適用 (3)

Tool	Description
patch_bytes	IDB 内の生バイトをパッチ
assemble_code	アドレスにある命令テキストをアセンブルし、任意でパッチ適用
export_program	パッチ適用済みバイナリまたは IDA データベースをディスクにエクスポート

ナビゲーション (4)

Tool	Description
navigate_to	IDA カーソルをアドレスに移動
bookmarks	統合ブックマーク管理 - アクション: list、set、remove
get_current_address	カーソル位置のアドレスとコンテキストを取得
get_current_function	カーソル位置の関数情報を取得

タスク管理 (4)

Tool	Description
start_task	非同期バックグラウンドタスクを開始
get_task_status	タスクの進捗を確認
cancel_task	実行中のタスクをキャンセル
list_tasks	すべての非同期タスクを一覧表示

プロジェクト構成

IDAssistMCP/
├── idassistmcp_plugin.py              # IDA plugin_t entry point
├── requirements.txt
├── README.md
└── src/
    └── idassist_mcp/
        ├── __init__.py
        ├── server.py                  # FastMCP server + transport
        ├── context.py                 # Single-binary IDA context
        ├── tools.py                   # 41 MCP tools (IDA API)
        ├── resources.py               # 8 MCP resources
        ├── prompts.py                 # 7 guided workflow prompts
        ├── config.py                  # Pydantic settings
        ├── cache.py                   # LRU analysis cache
        ├── tasks.py                   # Async task manager
        ├── logging.py                 # IDA logging wrapper
        ├── utils.py                   # IDA-specific utilities
        └── ui/
            └── tool_registry.py       # Tool catalog for UI

ライセンス

詳細は LICENSE ファイルを参照してください。