Локальный, детерминированный MCP-сервер для IDA Pro/Home: 109 строго типизированных операций обратного инжиниринга, выводы с подтверждением доказательствами и редактирование IDB с контролем политик.
⚠️ Архив — заменён официальным сервером Hex-Rays IDA MCP
Этот проект больше не поддерживается. 2026-09-27 компания Hex-Rays SA выпустила Официальный сервер IDA MCP и IDA Nexus. Разработка остановлена в тот же день на версии
1.0.0a4.Для текущего использования установите их решение:
uvx ida-hcli mcp install. Оно требует IDA 9.4+ сidalibи полностью работает без графического интерфейса; GUI-плагин опционален.Этот репозиторий сохранён ради его набора тестов, документации и архитектурной записи. См. ARCHIVE.md для полного заключительного отчёта: чем был проект, почему он проиграл, какие части были строительными лесами, а какие части всё ещё чего-то стоят. Остальная часть этого README описывает систему, которая больше не рекомендуется к использованию.
IDA Pro MCP — это локальный сервер Model Context Protocol для IDA Pro. Он позволяет MCP-клиенту исследовать IDB, запрашивать у IDA детерминированные результаты анализа и, при явном разрешении, записывать аннотации или другие изменения обратно в IDB. Хост-процесс работает вне IDA и по умолчанию запускает отдельный headless-процесс IDA для каждой сессии.
ida_* со строгой схемой
и живым обнаружением через tools/list и ida_help.Текущая версия — 1.0.0a4. Это альфа-программное обеспечение. Публичные
имена операций ida_*, схемы и формат рабочего пространства могут измениться до
стабильного релиза 1.0.0. Поверхность клиента по умолчанию содержит 102 операции с точной схемой.
Используйте живое обнаружение для получения полного контракта: tools/list перечисляет каждую
операцию с её схемой, а ida_help(topic="...") возвращает точные
аргументы и пример для одной операции.
Вам потребуется:
idat/idat64.
Живые тестовые доказательства репозитория охватывают IDA 9.3 и 9.4; 9.2 — это
заявленный минимальный уровень совместимости.Обычный анализ не требует провайдера интеллекта. Явные
режимы интеллекта — jev, custom и disabled; отключённый режим сохраняет
доступным детерминированный лексический поиск, и нет локального, Gemini или
нативного модельного запасного варианта.
Среда выполнения по умолчанию — idat: один headless-процесс IDA на сессию.
Бэкенд idalib экспериментален, требует установки IDA 9.3 или новее
с активированным пакетом idapro и не нужен для первой установки.
Установщик создаёт управляемое окружение в корне установки, устанавливает замороженную копию репозитория в него и записывает конфигурацию клиента для поддерживаемых расположений клиентов. Из корня репозитория выполните:
python3 install.py
Для известной установки IDA передайте её явно:
python3 install.py --ida-dir /path/to/ida-pro-9.3
Для неинтерактивного запуска:
python3 install.py --yes --no-ida-prompt --ida-dir /path/to/ida-pro-9.3
Установщик также может найти IDA через IDADIR, IDA_DIR, исполняемые файлы IDA в PATH и стандартные каталоги установки. --ida-version выбирает версию, если установлено несколько. Используйте --dry-run, чтобы сначала просмотреть планируемые изменения.
Установщик никогда не загружает модель провайдера или среду выполнения. Он может создавать или обновлять файлы конфигурации для каждого расположения клиента во встроенной карте клиентов, включая клиентов, которые не установлены на вашей машине. Проверьте install-report.json в корневом каталоге установки и при необходимости удалите неиспользуемые записи. Существующие обычные файлы конфигурации создаются резервные копии перед изменением; некорректные, символические ссылки или не обычные файлы отклоняются, а не перезаписываются.
Перезапустите MCP-клиент после установки, чтобы он перезагрузил свою конфигурацию.
Агентные обвязки обнаруживают поверхность инструментов в реальном времени: tools/list перечисляет каждую операцию с её схемой, а ida_help(topic="...") возвращает точные аргументы и пример. Статические файлы навыков не устанавливаются.
Корневой каталог установки по умолчанию:
~/.local/share/ida-pro-mcp%LOCALAPPDATA%/ida-pro-mcpЗадайте IDA_PRO_MCP_HOME или передайте --install-root, чтобы выбрать другое расположение.
Альфа-релизы собираются GitHub Actions и публикуются вручную как пререлизы. Когда релиз доступен, скачайте ресурс bundle.zip или bundle.tar.gz и его файл SHA256SUMS со страницы релизов. Проверьте контрольную сумму, распакуйте пакет и запустите установщик из его каталога верхнего уровня:
python3 install.py --yes --no-ida-prompt --ida-dir /path/to/ida-pro-9.3
Пакет также содержит wheel и дистрибутив исходного кода для сценариев установки Python. Пакет — это самый простой путь, поскольку он включает установщик и все файлы проекта, необходимые для настройки клиента MCP. Релизы имеют альфа-качество; сохраните оригинальный бинарный файл и IDB и прочитайте примечания к релизу перед обновлением.
Установщик записывает запись сервера для известных ему путей конфигурации клиентов. Он поддерживает Gemini CLI, Antigravity, Antigravity IDE, Antigravity CLI, Claude Code, Codex, Copilot CLI, OpenCode, Claude Desktop, Cursor, VS Code, Windsurf, Cline и Roo Code. Клиенты OpenCode и семейства Copilot используют разные форматы конфигурации; позвольте установщику записать эти файлы или следуйте руководству по настройке OpenCode.
Для клиента, использующего общий формат JSON, запись эквивалентна:
{
"mcpServers": {
"ida-pro-mcp": {
"command": "/path/to/ida-pro-mcp/.venv/bin/python",
"args": ["-u", "-m", "ida_pro_mcp.host.server"],
"env": {
"IDA_PRO_MCP_HOME": "/path/to/ida-pro-mcp",
"IDADIR": "/path/to/ida-pro-9.3",
"IDA_MCP_TOOL_SURFACE": "agent"
}
}
}
}
В Windows используйте управляемый интерпретатор по пути
<install-root>/.venv/Scripts/python.exe. Важные детали — это
управляемый интерпретатор, -u -m ida_pro_mcp.host.server, выбранный каталог
IDA и IDA_MCP_TOOL_SURFACE=agent. Не указывайте клиенту на
install.py; этот файл является установщиком, а не MCP-сервером.