IDAssistMCP

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

Возможности

• 41 MCP-инструмент, охватывающий бинарный анализ, декомпиляцию, перекрёстные ссылки, управление символами, систему типов, навигацию, патчинг, экспорт и многое другое
• 6 объединённых инструментов с параметрами action/format/direction для комментариев, переменных, типов, перекрёстных ссылок, закладок и кода
• 8 MCP-ресурсов для просмотра бинарных метаданных (общая информация, функции, импорты, экспорты, строки, сведения, сегменты, секции)
• 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:

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

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

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

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

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

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

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

Комментарии (1 объединённый)

Переменные (1 объединённый)

Типы (2 — 1 объединённый + 1 отдельный)

Поиск функций (5)

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

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

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

Патчинг (3)

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

Управление задачами (4)

Структура проекта

IDAssistMCP/
├── idassistmcp_plugin.py              # Точка входа плагина IDA
├── requirements.txt
├── README.md
└── src/
    └── idassist_mcp/
        ├── __init__.py
        ├── server.py                  # Сервер FastMCP + транспорт
        ├── context.py                 # Контекст одного бинарного файла IDA
        ├── tools.py                   # 41 MCP-инструмент (IDA API)
        ├── resources.py               # 8 MCP-ресурсов
        ├── prompts.py                 # 7 подсказок для направленных рабочих процессов
        ├── config.py                  # Настройки Pydantic
        ├── cache.py                   # LRU-кэш анализа
        ├── tasks.py                   # Менеджер асинхронных задач
        ├── logging.py                 # Обёртка для логирования IDA
        ├── utils.py                   # Утилиты для IDA
        └── ui/
            └── tool_registry.py       # Каталог инструментов для UI

Лицензия

Подробности см. в файле LICENSE.