IDAssistMCP

[!IMPORTANT] Планируемое архивирование: IDAssistMCP планируется к архивированию, так как IDA Pro представляет встроенный нативный MCP-сервер. Нативная поддержка устраняет необходимость поддерживать отдельную интеграцию MCP и обеспечивает её согласованность с самой IDA Pro. Пожалуйста, используйте нативный MCP-сервер IDA Pro, как только он станет доступен в вашей установленной версии. Этот репозиторий останется доступным для справки.

Автономный плагин MCP-сервера (Model Context Protocol) для IDA Pro 9.x, предоставляющий возможности анализа IDA LLM-клиентам, таким как Claude Desktop.

Возможности

• 41 инструмент MCP, охватывающий бинарный анализ, декомпиляцию, перекрёстные ссылки, управление символами, систему типов, навигацию, патчинг, экспорт и многое другое
• 6 консолидированных инструментов с параметрами action/format/direction для комментариев, переменных, типов, xrefs, закладок и кода
• 8 ресурсов MCP для просмотра метаданных бинарного файла (triage, функции, импорты, экспорты, строки, информация, сегменты, секции)
• 7 управляемых промптов для типовых рабочих процессов обратной разработки (анализ функций, выявление уязвимостей, документирование, трассировка потоков данных, сравнение функций, восстановление структур, анализ сетевых протоколов)
• Транспорты SSE и Streamable HTTP через ASGI-сервер Hypercorn
• Потокобезопасные модификации IDB через обёртку execute_on_main_thread()
• LRU-кэш анализа для дорогостоящих операций, таких как декомпиляция
• Асинхронный менеджер задач для длительных операций
• Конфигурация Pydantic с поддержкой переменных окружения (префикс IDASSISTMCP_)

Установка

Предварительные требования

• IDA Pro 9.x с Python 3.10+
• Декомпилятор Hex-Rays (опционально, для инструментов декомпиляции)

Вариант 1: Менеджер плагинов IDA (рекомендуется)

hcli plugin install idassistmcp

Это автоматически устанавливает плагин и его зависимости Python.

Вариант 2: Ручная установка (из релизного архива)

Скачайте последний релизный zip-архив со страницы GitHub Releases и распакуйте его в каталог плагинов IDA:

Linux / macOS:

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

Windows: Распакуйте zip-архив в %APPDATA%\Hex-Rays\IDA Pro\plugins\.

Затем установите зависимости, используя встроенный Python IDA (не системный 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 для указания пользовательского каталога плагинов.

Использование

Запуск сервера

1. Откройте бинарный файл в IDA Pro
2. Нажмите Ctrl+Shift+M или перейдите в Edit > Plugins > IDAssistMCP
3. URL MCP-сервера будет выведен в окно вывода IDA
4. Нажмите Ctrl+Shift+M снова, чтобы остановить сервер

Конфигурация Claude Desktop

Добавьте в ваш claude_desktop_config.json для Claude Desktop:

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

Переменные окружения

Настройка через переменные окружения с префиксом IDASSISTMCP_:

Переменная	По умолчанию	Описание
IDASSISTMCP_SERVER__HOST	localhost	Адрес привязки сервера
IDASSISTMCP_SERVER__PORT	9080	Порт сервера
IDASSISTMCP_SERVER__TRANSPORT	streamablehttp	Тип транспорта (sse или streamablehttp)
IDASSISTMCP_DEBUG	false	Включить режим отладки
IDASSISTMCP_LOG_LEVEL	INFO	Уровень логирования

Справочник инструментов

Управление бинарными файлами (2)

Инструмент	Описание
list_binaries	Список текущего загруженного бинарного файла
get_binary_info	Подробные метаданные бинарного файла (архитектура, хэши, сегменты)

Анализ кода (4)

Инструмент	Описание
get_code	Получить код функции — format: 'decompile' (псевдо-C) или 'disasm' (ассемблер)
analyze_function	Комплексный анализ: метаданные, CFG, вызывающие/вызываемые, декомпиляция
get_basic_blocks	Базовые блоки CFG с преемниками/предшественниками
get_function_stack_layout	Разметка стекового фрейма (локальные переменные, аргументы, сохранённые регистры)

Перекрёстные ссылки (1 консолидированный)

Инструмент	Действия	Описание
xrefs	direction: to/from/both, include_calls: bool	Xrefs и опциональные вызывающие/вызываемые для адреса

Комментарии (1 консолидированный)

Инструмент	Действия	Описание
comments	action: get, set, list, remove	Управление комментариями (обычными, повторяемыми, функции)

Переменные (1 консолидированный)

Инструмент	Действия	Описание
variables	action: list, rename	Список локальных переменных или переименование локальных/глобальных переменных с scope: auto, local, global

Типы (2 — 1 консолидированный + 1 автономный)

Инструмент	Действия / Описание
types	action: list, set, create_struct, create_enum — управление типами IDB
get_classes	Список типов структур/классов из библиотеки типов

Обнаружение функций (5)

Инструмент	Описание
get_functions	Все функции с фильтрацией и постраничной навигацией
search_functions_by_name	Поиск по шаблону имени и фильтрам размера
get_function_by_name	Точный поиск по имени
get_function_by_address	Поиск по адресу
get_function_statistics	Агрегированная статистика (количество, размеры, топ-10)

Управление символами (2)

Инструмент	Описание
rename_symbol	Переименовать любой символ (функцию или данные)
batch_rename	Пакетное переименование нескольких символов

Информация о бинарном файле (5)

Инструмент	Описание
get_imports	Таблица импортов, сгруппированная по модулям
get_exports	Таблица экспортов
get_strings	Таблица строк с постраничной навигацией
get_segments	Сегменты памяти с правами доступа
get_entry_points	Все точки входа бинарного файла

Анализ данных (6)

Инструмент	Описание
read_memory	Чтение сырых байтов по адресу
get_data_at	Получить типизированные данные по адресу
search_bytes	Поиск по бинарному байтовому шаблону
search_strings	Поиск строк с постраничной навигацией
create_data_var	Определить переменную данных по адресу (byte/word/dword/qword/float/ascii/C type)
get_data_vars	Список определённых переменных данных (не-кодовых элементов)

Патчинг (3)

Инструмент	Описание
patch_bytes	Патчинг сырых байтов в IDB
assemble_code	Ассемблировать текст инструкции по адресу и опционально пропатчить его
export_program	Экспортировать пропатченный бинарный файл или базу данных IDA на диск

Навигация (4)

Инструмент	Описание
navigate_to	Переместить курсор IDA на адрес
bookmarks	Консолидированное управление закладками — действия: list, set, remove
get_current_address	Получить адрес и контекст в позиции курсора
get_current_function	Получить информацию о функции в позиции курсора