Skip to main content
Glama
IDA Pro MCP Server

IDA Pro MCP Server

by 31Benzi

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-mcp

3. 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 個)

ツール

説明

decompile_function

Hex-Rays C 疑似コードの逆コンパイル

disassemble_function

関数の完全なアセンブリリスト

disassemble_range

2 つのアドレス間のアセンブリ

get_bytes

アドレスから生の 16 進バイトを読み取り

ナビゲーションと検出(14 個)

ツール

説明

list_functions

オプションのフィルター付きで全関数を一覧表示

get_function_info

関数の詳細なメタデータ

list_segments

パーミッション付きのメモリセグメント

get_xrefs_to

アドレスへのクロスリファレンス

get_xrefs_from

アドレスからのクロスリファレンス

list_strings

オプションのフィルター付きで定義済み文字列を一覧表示

get_imports

モジュールごとのインポート関数

get_exports

エクスポート関数とエントリポイント

list_structs

構造体、共用体、メンバーレイアウト

list_enums

列挙型と値

create_struct

新しい構造体型を作成

get_function_callers

ターゲットを呼び出す関数(呼び出しサイト付き)

get_function_callees

ターゲットが呼び出す関数

make_string

アドレスに C スタイル文字列を定義

イントロスペクション(14 個)

ツール

説明

get_flowchart

制御フローグラフ — 先行/後続ブロック付きの基本ブロック

get_comment

アドレスのコメントを読み取り

get_all_comments

関数内のすべてのコメントを読み取り

get_function_comment

関数レベルのコメントを読み取り

set_function_comment

関数レベルのコメントを設定

get_stack_frame

完全なスタックフレームレイアウト(ローカル変数、引数、保存レジスタ)

set_operand_type

オペランド表示を変更(16 進/10 進/2 進/文字)

set_local_variable_type

逆コンパイル内のローカル変数の型を変更

get_color

命令/関数/セグメントの色を取得

set_color

命令/関数/セグメントの色を設定(RGB)

get_function_hash

関数バイトのハッシュ(MD5/SHA1/SHA256)

get_exception_info

関数内の try/catch/throw を検出

get_microcode

任意の成熟度レベルの Hex-Rays 中間表現

変更(7 個)

ツール

説明

rename_function

関数の名前を変更

rename_address

ラベル、変数、アドレスの名前を変更

set_comment

通常または繰り返し可能なコメントを設定

set_function_type

C 関数シグネチャ/プロトタイプを設定

set_type

アドレスに型を設定

rename_local_variable

ローカル変数の名前を変更(Hex-Rays)

apply_callee_type

呼び出しサイトに型を適用

検索(2 個)

ツール

説明

search_text

逆アセンブリ内のテキスト検索

search_bytes

バイトパターン/シグネチャ検索

デバッガ(17 個)

ツール

説明

start_debugger

バイナリのデバッグを開始

get_debugger_status

デバッガのアクティブ/サスペンド状態を確認

set_breakpoint

ソフトウェアブレークポイントを設定

delete_breakpoint

ブレークポイントを削除

list_breakpoints

すべてのブレークポイントを一覧表示

enable_breakpoint

ブレークポイントを有効/無効化

step_into

次の命令にステップイン

step_over

次の命令をステップオーバー

continue_execution

次のブレークポイントまで続行

suspend_debugger

実行を一時停止

exit_debugger

プロセスを終了

get_registers

CPU レジスタを読み取り

read_debug_memory

デバッグ中のプロセスからメモリを読み取り(ASCII 付き 16 進ダンプ)

get_stack_trace

コールスタックトレース

list_debugger_threads

すべてのプロセススレッドを一覧表示

switch_thread

アクティブなデバッガスレッドを切り替え

add_watchpoint

ハードウェアウォッチポイントを設定(読み取り/書き込み/実行)

高度な機能(14 個)

ツール

説明

patch_bytes

IDA データベース内のバイトをパッチ

execute_idapython

任意の IDAPython コードを実行

load_type_library

.til 型情報ライブラリを読み込み

list_type_libraries

読み込まれた TIL を一覧表示

make_code

バイトをコード(命令)に変換

make_data

バイトを型付きデータに変換

undefine

未定義の生バイトに戻す

define_function

アドレス範囲に関数を作成

undefine_function

関数定義を削除

add_bookmark

永続的なブックマークを追加

list_bookmarks

すべてのブックマークを一覧表示

delete_bookmark

ブックマークを削除

get_local_variables

ローカル変数と引数を一覧表示

get_global_variables

名前付きグローバルデータ変数を一覧表示

データベースとエクスポート(12 個)

ツール

説明

save_database

IDA データベースを保存

apply_flirt_signature

ライブラリ識別用の FLIRT .sig を適用

list_flirt_signatures

適用済みの FLIRT シグネチャを一覧表示

create_segment

新しいメモリセグメントを作成

delete_segment

セグメント定義を削除

set_segment_permissions

セグメントの rwx パーミッションを変更

create_array

型付き配列を定義

navigate_to

IDA カーソルをアドレスにジャンプ

produce_asm

クリーンなアセンブリリストをエクスポート

produce_c

クリーンな C 疑似コードをエクスポート

run_idc_script

IDC スクリプトコードを実行

run_ida_action

登録済みの IDA UI アクションをトリガー

list_ida_actions

利用可能なすべての IDA アクションを一覧表示

メタ(3 個)

ツール

説明

get_binary_info

ファイルパス、アーキテクチャ、ビット数、エントリポイント

get_analysis_status

自動解析の完了を確認

ping

IDA の接続状態を確認

Available Tools

87 tools
add_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

    B3.1/5.0

    Scored across 87 tools

    Disambiguation2/5

    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.

    Naming Consistency4/5

    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.

    Tool Count1/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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      Enables 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.
      56
      4
      MIT
    • A
      license
      Not graded
      quality
      F
      maintenance
      Enables 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.
      50
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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