IDA Pro MCP Server
Claude Code 向け IDA Pro MCP サーバー
Claude Code(CLI および VS Code、Cursor、Windsurf などのエディター拡張機能)と IDA Pro 9.0+ を連携させ、AI 支援によるリバースエンジニアリングを実現します。87 のツール で IDA Pro のほぼすべての機能をカバー。
アーキテクチャ
Claude Code / Cursor / VS Code (MCP Client)
│ (stdio)
▼
ida-mcp Server
│ (JSON-RPC over localhost:13337)
▼
IDA Pro Plugin (ida_mcp_plugin.py)
│ (IDAPython API on main thread)
▼
IDA Pro 9.0+Related MCP server: IDA Pro MCP Multi
インストールとセットアップ
1. IDA プラグインのインストール
ida_plugin/ida_mcp_plugin.py を IDA Pro の plugins ディレクトリにコピーします。
macOS:
~/idapro-9.0/plugins/または/Applications/IDA Professional 9.0.app/Contents/MacOS/plugins/Windows:
%APPDATA%\Hex-Rays\IDA Pro\plugins\またはC:\Program Files\IDA Professional 9.0\plugins\Linux:
~/.idapro/plugins/または/opt/idapro-9.0/plugins/
IDA Pro で任意のバイナリを開くと、プラグインが 127.0.0.1:13337 で JSON-RPC サーバーを起動します。
2. Claude Code CLI の設定
claude mcp add ida-pro -- uv run --directory "/Users/benzi/Documents/IDA MCP" ida-mcp3. VS Code / Cursor / Windsurf の設定
.mcp.json またはエディターの MCP 設定に以下を追加します。
{
"mcpServers": {
"ida-pro": {
"command": "uv",
"args": ["run", "--directory", "/Users/benzi/Documents/IDA MCP", "ida-mcp"]
}
}
}環境変数
IDA_MCP_HOST— ホストを上書き(デフォルト:127.0.0.1)IDA_MCP_PORT— ポートを上書き(デフォルト:13337)
利用可能なツール(全 87 個)
解析(4 個)
ツール | 説明 |
| Hex-Rays C 疑似コードの逆コンパイル |
| 関数の完全なアセンブリリスト |
| 2 つのアドレス間のアセンブリ |
| アドレスから生の 16 進バイトを読み取り |
ナビゲーションと検出(14 個)
ツール | 説明 |
| オプションのフィルター付きで全関数を一覧表示 |
| 関数の詳細なメタデータ |
| パーミッション付きのメモリセグメント |
| アドレスへのクロスリファレンス |
| アドレスからのクロスリファレンス |
| オプションのフィルター付きで定義済み文字列を一覧表示 |
| モジュールごとのインポート関数 |
| エクスポート関数とエントリポイント |
| 構造体、共用体、メンバーレイアウト |
| 列挙型と値 |
| 新しい構造体型を作成 |
| ターゲットを呼び出す関数(呼び出しサイト付き) |
| ターゲットが呼び出す関数 |
| アドレスに C スタイル文字列を定義 |
イントロスペクション(14 個)
ツール | 説明 |
| 制御フローグラフ — 先行/後続ブロック付きの基本ブロック |
| アドレスのコメントを読み取り |
| 関数内のすべてのコメントを読み取り |
| 関数レベルのコメントを読み取り |
| 関数レベルのコメントを設定 |
| 完全なスタックフレームレイアウト(ローカル変数、引数、保存レジスタ) |
| オペランド表示を変更(16 進/10 進/2 進/文字) |
| 逆コンパイル内のローカル変数の型を変更 |
| 命令/関数/セグメントの色を取得 |
| 命令/関数/セグメントの色を設定(RGB) |
| 関数バイトのハッシュ(MD5/SHA1/SHA256) |
| 関数内の try/catch/throw を検出 |
| 任意の成熟度レベルの Hex-Rays 中間表現 |
変更(7 個)
ツール | 説明 |
| 関数の名前を変更 |
| ラベル、変数、アドレスの名前を変更 |
| 通常または繰り返し可能なコメントを設定 |
| C 関数シグネチャ/プロトタイプを設定 |
| アドレスに型を設定 |
| ローカル変数の名前を変更(Hex-Rays) |
| 呼び出しサイトに型を適用 |
検索(2 個)
ツール | 説明 |
| 逆アセンブリ内のテキスト検索 |
| バイトパターン/シグネチャ検索 |
デバッガ(17 個)
ツール | 説明 |
| バイナリのデバッグを開始 |
| デバッガのアクティブ/サスペンド状態を確認 |
| ソフトウェアブレークポイントを設定 |
| ブレークポイントを削除 |
| すべてのブレークポイントを一覧表示 |
| ブレークポイントを有効/無効化 |
| 次の命令にステップイン |
| 次の命令をステップオーバー |
| 次のブレークポイントまで続行 |
| 実行を一時停止 |
| プロセスを終了 |
| CPU レジスタを読み取り |
| デバッグ中のプロセスからメモリを読み取り(ASCII 付き 16 進ダンプ) |
| コールスタックトレース |
| すべてのプロセススレッドを一覧表示 |
| アクティブなデバッガスレッドを切り替え |
| ハードウェアウォッチポイントを設定(読み取り/書き込み/実行) |
高度な機能(14 個)
ツール | 説明 |
| IDA データベース内のバイトをパッチ |
| 任意の IDAPython コードを実行 |
| .til 型情報ライブラリを読み込み |
| 読み込まれた TIL を一覧表示 |
| バイトをコード(命令)に変換 |
| バイトを型付きデータに変換 |
| 未定義の生バイトに戻す |
| アドレス範囲に関数を作成 |
| 関数定義を削除 |
| 永続的なブックマークを追加 |
| すべてのブックマークを一覧表示 |
| ブックマークを削除 |
| ローカル変数と引数を一覧表示 |
| 名前付きグローバルデータ変数を一覧表示 |
データベースとエクスポート(12 個)
ツール | 説明 |
| IDA データベースを保存 |
| ライブラリ識別用の FLIRT .sig を適用 |
| 適用済みの FLIRT シグネチャを一覧表示 |
| 新しいメモリセグメントを作成 |
| セグメント定義を削除 |
| セグメントの rwx パーミッションを変更 |
| 型付き配列を定義 |
| IDA カーソルをアドレスにジャンプ |
| クリーンなアセンブリリストをエクスポート |
| クリーンな C 疑似コードをエクスポート |
| IDC スクリプトコードを実行 |
| 登録済みの IDA UI アクションをトリガー |
| 利用可能なすべての IDA アクションを一覧表示 |
メタ(3 個)
ツール | 説明 |
| ファイルパス、アーキテクチャ、ビット数、エントリポイント |
| 自動解析の完了を確認 |
| IDA の接続状態を確認 |
Available Tools
87 toolsadd_bookmarkA
Add a bookmark at an address with optional description. Bookmarks persist in the IDA database.
Inputs: address (required), description. Returns: result
add_watchpointC
Set a hardware watchpoint (data breakpoint). Triggers when memory at address is accessed. watch_type: write, read, execute.
Inputs: address (required), size, watch_type. Returns: result
apply_callee_typeB
Apply a type signature to a call site (callee). Useful when the function pointer type is unknown at a call instruction.
Inputs: address (required), prototype (required). Returns: result
apply_flirt_signatureB
Apply a FLIRT signature file (.sig) to identify library functions in stripped binaries. Pass the signature name (e.g. 'vc64rtf' for MSVC runtime).
Inputs: sig_name (required). Returns: result
continue_executionB
Continue process execution until the next breakpoint or event.
Inputs: no named parameters. Returns: result
create_arrayA
Create an array at an address. element_type: byte, word, dword, qword. count: number of elements.
Inputs: count (required), address (required), element_type. Returns: result
create_segmentB
Create a new memory segment. permissions: bitmask (4=read, 2=write, 1=execute, 7=rwx). seg_class: CODE, DATA, BSS, STACK, etc.
Inputs: name (required), end_address (required), start_address (required), seg_class, +1 more. Returns: result
create_structA
Create a new structure type. Pass a name and list of fields, each with 'name' and 'type' keys. Example fields: [{"name": "size", "type": "int"}, {"name": "data", "type": "char *"}]
Inputs: name (required), fields (required). Returns: result
decompile_functionA
Decompile a function using the Hex-Rays decompiler. Pass a function name or hex address (e.g. '0x401000' or 'main'). Returns C-like pseudocode.
Inputs: identifier (required). Returns: result
define_functionB
Create a new function at a given address range. If end_address is empty, IDA will auto-detect the function boundary.
Inputs: start_address (required), end_address. Returns: result
delete_bookmarkA
Delete a bookmark by slot number (get slot numbers from list_bookmarks).
Inputs: slot (required). Returns: result
delete_breakpointC
Delete a breakpoint at an address.
Inputs: address (required). Returns: result
delete_segmentB
Delete the segment containing the given address. The data is kept but the segment definition is removed.
Inputs: address (required). Returns: result
disassemble_functionB
Get the assembly listing of a function. Pass a function name or hex address (e.g. '0x401000' or 'main').
Inputs: identifier (required). Returns: result
disassemble_rangeA
Disassemble an arbitrary address range. Pass hex addresses (e.g. '0x401000', '0x401100').
Inputs: end_address (required), start_address (required). Returns: result
enable_breakpointC
Enable or disable a breakpoint without removing it.
Inputs: address (required), enable. Returns: result
execute_idapythonB
Execute arbitrary IDAPython code inside the IDA session. Set 'result' or 'output' variable in your script to return data. Example: 'import idc; result = idc.get_screen_ea()'
Inputs: code (required). Returns: result
exit_debuggerB
Terminate the debugged process and stop the debugger.
Inputs: no named parameters. Returns: result
get_all_commentsA
Get all comments within a function (both regular and repeatable). Pass function name or address.
Inputs: identifier (required). Returns: result
get_analysis_statusA
Check if IDA's auto-analysis has completed. Some tools may return incomplete results if analysis is still running.
Inputs: no named parameters. Returns: result
get_binary_infoA
Get metadata about the currently loaded binary (filename, architecture, bitness, entry point).
Inputs: no named parameters. Returns: result
get_bytesB
Read raw bytes from an address. Returns hex dump. Default reads 16 bytes.
Inputs: address (required), size. Returns: result
get_colorB
Get the color of an instruction, function, or segment. Returns hex RGB value.
Inputs: address (required), item_type. Returns: result
get_commentB
Read the comment at an address. Set is_repeatable=True for repeatable comments.
Inputs: address (required), is_repeatable. Returns: result
get_debugger_statusA
Check if the debugger is currently active and whether execution is suspended.
Inputs: no named parameters. Returns: result
get_exception_infoA
Check if a function contains exception handling (try/catch/throw). Returns the decompiled code if exception handling is found.
Inputs: identifier (required). Returns: result
get_exportsB
List all exported functions/symbols.
Inputs: no named parameters. Returns: result
get_flowchartB
Get the control flow graph (basic blocks and edges) of a function. Shows predecessors and successors for each block. Essential for understanding branch logic.
Inputs: identifier (required). Returns: result
get_function_calleesA
Get all functions called by a given function. Shows what a function depends on.
Inputs: identifier (required). Returns: result
get_function_callersA
Get all functions that call a given function. Higher-level than xrefs — groups by calling function and shows call sites.
Inputs: identifier (required). Returns: result
get_function_commentB
Read the function-level comment (appears above/below the function header in disassembly).
Inputs: identifier (required), is_repeatable. Returns: result
get_function_hashA
Calculate a hash of a function's raw bytes. Useful for identifying identical/similar functions across binaries. Algorithms: md5, sha1, sha256.
Inputs: identifier (required), algorithm. Returns: result
get_function_infoA
Get detailed information about a function. Pass a function name or hex address.
Inputs: identifier (required). Returns: result
get_global_variablesA
List named global data variables in the binary. Optionally filter by substring.
Inputs: filter. Returns: result
get_importsB
List all imported functions grouped by module.
Inputs: no named parameters. Returns: result
get_local_variablesA
Get all local variables and arguments of a decompiled function. Requires Hex-Rays. Pass function name or address.
Inputs: identifier (required). Returns: result
get_microcodeB
Get the Hex-Rays intermediate representation (microcode) for a function. Maturity levels: generated, preoptimized, locopt, calls, glbopt1, glbopt2, glbopt3, lvars.
Inputs: identifier (required), maturity. Returns: result
get_registersA
Read all CPU register values. Requires the debugger to be active and suspended.
Inputs: no named parameters. Returns: result
get_stack_frameA
Get the complete stack frame layout of a function — all stack variables, their offsets, sizes, and the overall frame geometry.
Inputs: identifier (required). Returns: result
get_stack_traceA
Get the current call stack trace. Requires active debugger.
Inputs: no named parameters. Returns: result
get_xrefs_fromA
Get all cross-references FROM an address (what does this location call/reference). Pass hex address or name.
Inputs: address (required). Returns: result
get_xrefs_toA
Get all cross-references TO an address (who calls/references this location). Pass hex address or name.
Inputs: address (required). Returns: result
list_bookmarksA
List all bookmarks in the IDA database.
Inputs: no named parameters. Returns: result
list_breakpointsC
List all currently set breakpoints with their status.
Inputs: no named parameters. Returns: result
list_debugger_threadsA
List all threads in the debugged process. Requires active debugger.
Inputs: no named parameters. Returns: result
list_enumsB
List all defined enumerations in the IDA database.
Inputs: no named parameters. Returns: result
list_flirt_signaturesA
List all FLIRT signatures currently applied to the database.
Inputs: no named parameters. Returns: result
list_functionsA
List all functions in the binary. Optionally pass a filter string to match function names (case-insensitive).
Inputs: filter. Returns: result
list_ida_actionsA
List all registered IDA UI actions that can be triggered with run_ida_action.
Inputs: no named parameters. Returns: result
list_segmentsB
List all segments (sections) in the binary with their permissions and sizes.
Inputs: no named parameters. Returns: result
list_stringsA
List all defined strings in the binary. Optionally filter by substring (case-insensitive).
Inputs: filter. Returns: result
list_structsA
List all defined structures/unions in the IDA database with their members.
Inputs: no named parameters. Returns: result
list_type_librariesB
List all loaded type information libraries (TILs) in the current database.
Inputs: no named parameters. Returns: result
load_type_libraryC
Load a type information library (.til) file into the current database.
Inputs: path (required). Returns: result
make_codeB
Convert bytes at an address into code (disassembled instruction). Optionally undefine 'size' bytes first.
Inputs: address (required), size. Returns: result
make_dataB
Convert bytes at an address into data. Types: byte, word, dword, qword, float, double.
Inputs: address (required), size, data_type. Returns: result
make_stringA
Define a C-style string at an address. Pass length=0 to auto-detect (null-terminated).
Inputs: address (required), length. Returns: result
patch_bytesB
Patch bytes at an address in the IDA database. Pass hex bytes with optional spaces (e.g. '90 90 90' for NOP sled, 'EB 05' for short jump).
Inputs: address (required), hex_bytes (required). Returns: result
pingA
Check connectivity to IDA Pro. Returns 'Connected' if the IDA plugin is running and reachable.
Inputs: no named parameters. Returns: result
produce_asmC
Produce a clean assembly listing for a function, suitable for copy-paste or file export.
Inputs: identifier (required). Returns: result
produce_cB
Produce clean C pseudocode for a function, suitable for copy-paste or file export. Requires Hex-Rays.
Inputs: identifier (required). Returns: result
read_debug_memoryA
Read memory from the debugged process. Requires active debugger. Returns hex dump.
Inputs: address (required), size. Returns: result
rename_addressC
Rename any address (global variable, label, etc). Pass hex address and new name.
Inputs: address (required), new_name (required). Returns: result
rename_functionA
Rename a function. Pass the current name or hex address, and the new name.
Inputs: new_name (required), identifier (required). Returns: result
rename_local_variableC
Rename a local variable or argument in a decompiled function. Requires Hex-Rays.
Inputs: new_name (required), old_name (required), function_identifier (required). Returns: result
run_ida_actionA
Trigger a registered IDA UI action by name (e.g. 'ToggleBnds', 'MakeCode'). Use list_ida_actions to see available actions.
Inputs: action_name (required). Returns: result
run_idc_scriptC
Execute IDC script code (IDA's native scripting language). Returns the evaluation result.
Inputs: code (required). Returns: result
save_databaseB
Save the IDA database. Pass a path to save to a specific location, or leave empty to save in-place.
Inputs: path. Returns: result
search_bytesA
Search for a byte pattern in the binary. Pass hex bytes with optional spaces (e.g. '90 90 90' or 'CC CC' or '48 8B 05').
Inputs: pattern (required), max_results. Returns: result
search_textA
Search through disassembly text for a string. Matches against instruction mnemonics, operands, and comments.
Inputs: query (required), max_results. Returns: result
set_breakpointA
Set a breakpoint at an address. Pass hex address or function name.
Inputs: address (required). Returns: result
set_colorA
Set the color of an instruction, function, or segment. Color is RGB as integer (e.g. 0xFF0000 for red, 0x00FF00 for green). item_type: instruction, function, segment.
Inputs: color (required), address (required), item_type. Returns: result
set_commentA
Set a comment at an address. Use is_repeatable=True for repeatable comments that propagate to xrefs.
Inputs: address (required), comment (required), is_repeatable. Returns: result
set_function_commentB
Set a function-level comment. These appear above (anterior) or below (posterior) the function header.
Inputs: comment (required), identifier (required), is_repeatable. Returns: result
set_function_typeA
Set a function's type/prototype. Pass function name or address, and C-style prototype (e.g. 'int __cdecl func(int a, char *b)').
Inputs: prototype (required), identifier (required). Returns: result
set_local_variable_typeC
Change the type of a local variable in a decompiled function. Requires Hex-Rays. Pass C-style type (e.g. 'SOCKET', 'struct sockaddr_in *').
Inputs: type_string (required), variable_name (required), function_identifier (required). Returns: result
set_operand_typeA
Change how an operand is displayed. operand_num: 0 for first, 1 for second. display_type: hex, decimal, octal, binary, char, default.
Inputs: address (required), operand_num (required), display_type (required). Returns: result
set_segment_permissionsB
Change the read/write/execute permissions of the segment containing the given address.
Inputs: address (required), read, write, execute. Returns: result
set_typeA
Set the type at an address. Pass hex address and C-style type declaration.
Inputs: address (required), type_str (required). Returns: result
start_debuggerB
Start the debugger for the currently loaded binary. Optionally pass command-line arguments and binary path.
Inputs: args, path. Returns: result
step_intoA
Step into the next instruction (follows calls into functions).
Inputs: no named parameters. Returns: result
step_overA
Step over the next instruction (executes calls without entering them).
Inputs: no named parameters. Returns: result
suspend_debuggerA
Suspend (pause) the running process.
Inputs: no named parameters. Returns: result
switch_threadA
Switch the debugger's active thread. Pass the thread ID from list_debugger_threads.
Inputs: tid (required). Returns: result
undefineC
Undefine (delete) items at an address, reverting them to raw bytes.
Inputs: address (required), size. Returns: result
undefine_functionC
Delete/undefine a function at an address. The code remains but is no longer treated as a function.
Inputs: address (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 87 tools
Multiple tool pairs overlap heavily: decompile_function vs produce_c, disassemble_function vs produce_asm, get_xrefs_to vs get_function_callers, and get_xrefs_from vs get_function_callees. Descriptions add nuance, but an agent could easily misselect without deep context, and type-setting/breakpoint tools further blur boundaries.
Tool names overwhelmingly follow a consistent verb_noun snake_case pattern (get_*, list_*, set_*, create_*, delete_*), which is excellent across 87 tools. Minor deviations like ping, undefine, step_into, step_over, and navigate_to keep it from being a perfect 5.
87 tools is far beyond the typical agent-facing MCP surface and includes redundant affordances such as decompile_function/produce_c and disassemble_function/produce_asm. Even for a comprehensive tool like IDA Pro, this should be consolidated or grouped into a smaller, more navigable set.
The server covers an impressively broad range of reverse-engineering workflows: static analysis, decompilation, debugging, patching, types, segments, bookmarks, scripting, and signatures. Minor gaps exist, such as no struct/enum deletion and no explicit comment deletion, but these are not critical given the overall depth.
Maintenance
Related MCP Connectors
Claude-powered AI tools: research, write, code, analyze, translate, debate, pitch, score, and more.
Code intelligence platform for AI agents. 20 tools for architecture, security & impact analysis.
AI Visibility and Content Intelligence tools for Claude and MCP-compatible agents.
Live SEO workflow tools for Claude Code, Codex, and AI agents.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables AI-assisted reverse engineering in IDA Pro by providing tools to analyze binaries, decompile functions, manage comments, search patterns, and interact with the IDA database through natural language.564MIT
- AlicenseNot gradedqualityDmaintenanceExtends IDA Pro with multi-instance support and vulnerability scanning for AI-assisted reverse engineering.12MIT
- AlicenseNot gradedqualityFmaintenanceEnables LLM clients like Claude to interact with IDA Pro for binary analysis, decompilation, cross-references, patching, and more via 41 MCP tools, 8 resources, and 7 guided prompts.50MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI clients such as Claude, Cursor, Cline, and Codex to remotely drive IDA Pro over HTTP through 88 tools, covering Hex-Rays decompilation, disassembly, cross-reference tracing, type and struct reconstruction, C header import, memory reading and patching, and full dynamic debugging with breakpoints, registers, and stepping.MIT