Hex-Rays IDA MCP — плагин
Официальный MCP-сервер Hex-Rays: агент открывает базы IDA, выполняет в них Python и разбирает бинарники. Плагины есть для Claude Code и Codex
- 1 347 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Инструмент execute_python выполняет произвольный Python-код внутри базы IDA, а save_database записывает изменения на диск
- Агент открывает любые бинарники по пути, включая потенциально вредоносные образцы
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/hex-rays-ida-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструмент execute_python выполняет произвольный Python-код внутри базы IDA, а save_database записывает изменения на диск
- Агент открывает любые бинарники по пути, включая потенциально вредоносные образцы
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает ИИ-агента к IDA, дизассемблеру от Hex-Rays. Агент получает шесть инструментов: open_database, execute_python, reference, list_databases, save_database и close_database. Основная работа идет через execute_python, где агент запускает Python-код прямо в открытой базе IDA. Сервер работает и без графического интерфейса через idalib, а плагин для IDA GUI дает доступ к базе, открытой в окне. Проект поставляется как плагин для Claude Code, Codex CLI и GitHub Copilot CLI, а также как расширение для Pi и oh-my-pi. Для остальных агентов в конфигурацию добавляется обычный stdio-сервер с командой uvx ida-mcp stdio. В плагины встроен хук PreToolUse: он привязывает вызовы IDA к транскрипту сессии агента. Отдельная команда ida-mcp dashboard открывает локальную панель с журналом вызовов, ошибками Python и временем работы по задачам. Команда ida-mcp logs собирает архив журналов для разбора проблем. Серверная часть опирается на библиотеку IDA Nexus, которая позволяет нескольким клиентам работать с одной базой.
Для кого. Для реверс-инженеров и исследователей безопасности с лицензией IDA 9.4 или новее, которые хотят поручить Claude Code, Codex или Copilot CLI рутину разбора бинарников.
Подходит, если
- Нужно разобрать образец вроде sample.elf: агент сам откроет базу, пройдет по функциям и вернет выводы
- Хочется узнать, какая база загружена в окне IDA прямо сейчас: плагин для GUI отвечает на вопрос «What do I have open in the IDA GUI?»
- Задачи требуют скриптов для IDAPython, а писать их по одному вручную долго: агент выполняет код в базе и видит результат
- Нужен разбор без графического окна, например на сервере: idalib запускает базу в фоновом режиме
- Хочется видеть, что агент делал в IDA: ida-mcp dashboard показывает вызовы, ошибки и время
Не подходит, если
- У вас нет IDA 9.4 или новее с idalib и Python 3.11 или новее: без них сервер не запустится
- Вы работаете в Ghidra или другом дизассемблере: сервер рассчитан только на IDA
- Git и uv отсутствуют, и поставить их нельзя: автоматическая установка и запуск идут через них
- Уже подключен другой MCP-сервер для IDA: автор советует его отключить, чтобы агент не путался в похожих инструментах
Пример запроса к агенту
Разбери /path/to/sample.elf в IDA: найди точку входа, перечисли строковые константы и опиши, что делает функция main.Ограничения
- Нужна лицензия IDA 9.4 или новее с idalib, Python 3.11 или новее, Git и uv.
- Без плагина для IDA GUI сервер работает только в фоновом режиме и не видит базы, открытые в окне.
- Инструмент execute_python выполняет произвольный Python-код внутри базы IDA, поэтому ответственность за запускаемый код лежит на вас.
- Проект официальный, но обслуживает только IDA: для других дизассемблеров он не подойдет.
- Автор советует отключить другие MCP-серверы для IDA, иначе агент путается в похожих инструментах.
Как отключить. В Claude Code удалите плагин командой claude plugin uninstall ida-mcp@HexRaysSA. Для остальных агентов уберите запись ida из mcpServers. Плагин для IDA GUI снимается через hcli plugin.
Частые вопросы
Как поставить IDA MCP в Claude Code?
Выполните uvx ida-hcli mcp install, программа предложит поставить плагин для GUI и плагины для поддерживаемых агентов. Вручную это две команды: claude plugin marketplace add HexRaysSA/claude-marketplace и claude plugin install ida-mcp@HexRaysSA.
Работает ли IDA MCP без запущенной IDA?
Да. Без плагина для IDA GUI сервер работает в фоновом режиме через idalib. Плагин нужен только чтобы агент видел базы, открытые в окне IDA. Лицензия IDA и idalib при этом все равно нужны.
Чем IDA MCP от Hex-Rays отличается от ida-pro-mcp?
Этот репозиторий выпускает сама Hex-Rays, разработчик IDA, и выдает агенту шесть инструментов с упором на выполнение Python в базе. Есть панель журнала вызовов и хуки для Claude Code, Codex и Copilot CLI. Требования выше: IDA 9.4 и новее.
Как посмотреть, что агент делал в IDA?
Запустите uvx ida-mcp dashboard --open. Панель собирает вызовы инструментов, ошибки Python и время работы по задачам. Для обращения в поддержку команда uvx ida-mcp logs собирает архив журналов.
Какие переменные окружения нужны для IDA MCP?
Ни одна не обязательна. IDAUSR задает каталог пользователя IDA, от него считается путь к журналам сессий, а IDA_MCP_STATE_DIR переопределяет этот путь. IDA_MCP_IDLE_TIMEOUT и IDA_MCP_ID настраивают простой и идентификатор процесса.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныMCP-сервер, который связывает IDA Pro с агентом: чтение декомпиляции, переименование и типизация, комментарии и запуск IDAPython прямо в базе
MCP-сервер для IDA Pro с несколькими headless-сессиями idalib: агент открывает бинарники, держит базы изолированно и работает по ключу доступа
MCP-сервер для IDA Pro с одной точкой входа на несколько открытых баз: декомпиляция, перекрестные ссылки и поиск похожих функций между бинарниками
Headless MCP-сервер для IDA Pro на Rust: агент открывает базу, перечисляет функции, дизассемблирует, декомпилирует и строит перекрестные ссылки
MCP-сервер для наступательной безопасности: агент запускает более 150 инструментов пентеста и разведки и ведет автоматическую проверку целей
Нативный MCP-плагин для отладчика x64dbg: агент управляет отладкой по HTTP, ставит точки останова, шагает по коду, читает и патчит память
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Hex-Rays IDA MCP (эта запись) | да | не нужна | 1 347 | |
| IDA Pro MCP | нет | не нужна | 13 079 | сторонний MCP-сервер для IDA, а эта запись выпущена самим вендором |
| ida-mcp-rs | нет | не нужна | 874 | другой сервер для IDA на Rust от стороннего автора |
Коротко о README
Репозиторий описывает установку и запуск официального сервера IDA MCP от Hex-Rays. Сначала перечислены требования: Git, uv, IDA 9.4 или новее с idalib и Python 3.11 или новее. Затем идет автоматическая установка через hcli и ручная для каждого агента. В конце README показывает команды CLI и два примера запросов к агенту. Разработчикам, которые хотят строить свои инструменты, он указывает на библиотеку IDA Nexus.