Skip to main content
Glama
IDA Pro MCP Server

IDA Pro MCP Server

by 31Benzi

IDA Pro MCP Сервер для Claude Code

Объединяет 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 в каталог plugins вашей IDA Pro:

  • 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 плагин запускает JSON-RPC сервер на 127.0.0.1:13337.

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

Декомпиляция C-псевдокода Hex-Rays

disassemble_function

Полный листинг ассемблера для функции

disassemble_range

Ассемблер между двумя адресами

get_bytes

Чтение сырых шестнадцатеричных байт по адресу

Навигация и поиск (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

Изменить отображение операнда (шестнадцатеричный/десятичный/двоичный/символ)

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

Чтение регистров ЦП

read_debug_memory

Чтение памяти из отлаживаемого процесса (hex dump с ASCII)

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
    ResponsivenessNo recent community issues

    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