GhidrAssistMCP

Установка

Работает в

• SourceCraft
• Koda
• Coddy

Ручная установка

./gradlew installExtension

Что делает

GhidrAssistMCP устанавливается как расширение в Ghidra и запускает внутри нее MCP-сервер. Сервер стартует вместе с менеджером проектов, раньше, чем откроется CodeBrowser, и один обслуживает все открытые окна. По умолчанию он слушает localhost:8080 и принимает подключения по Streamable HTTP (адрес /mcp) и по SSE (адреса /sse и /message). Агент получает 100 именованных инструментов, по умолчанию включены 93: список функций и поиск по ним, псевдокод, дизассемблер, P-code, граф потока управления, импорты, экспорты, строки, блоки памяти, шестнадцатеричный дамп, перекрестные ссылки, вызывающие и вызываемые функции. Кроме чтения, инструменты меняют проект: переименовывают локальные переменные, задают типы и прототипы функций, создают структуры и их поля, выводят структуру из переменной, ставят и удаляют комментарии, запускают и отменяют анализ программы. Отдельные инструменты создают, открывают, сохраняют и закрывают проекты Ghidra и открывают программу из проекта в CodeBrowser. Каждый ответ начинается с пометки о том, над какой программой идет работа и какое окно в фокусе, поэтому при нескольких открытых бинарниках агент выбирает цель по полю program_name. Длинные операции выполняются в фоне: сервер возвращает идентификатор задачи, статус смотрят через get_task_status, отмену дает cancel_task. Повторяющиеся запросы кэшируются. Вместе с инструментами сервер отдает шесть шаблонов ресурсов (сведения о программе, функции, строки, импорты, экспорты, сегменты) и семь готовых промптов, среди них разбор функции, поток данных, сетевые данные и сравнение. В окне Window, GhidrAssistMCP видны журнал запросов и ответов и настройки: порт, список инструментов с флажками, выключатель сервера. Без графического окна расширение запускается скриптом GAMCPStartServerScript.java через analyzeHeadless.

Для кого. Для специалистов по обратной разработке, исследователей безопасности и участников CTF, которые разбирают бинарные файлы в Ghidra и хотят, чтобы ИИ-агент через MCP-клиент работал с открытым проектом.

Пример запроса к агенту

Открой в Ghidra функцию main, прочитай ее псевдокод и предложи имена для всех функций, которые она вызывает

MCP

Транспорт

http, sse

Авторизация

не нужна

Ограничения

• Лицензия MIT. Версия 3.0.0 переименовала и разделила инструменты прежнего набора, поэтому после обновления клиенту нужно заново запросить список инструментов, а сохраненные запросы со старыми именами не сработают.
• Нужны Ghidra 12.0 или 12.1 и Java 25 или новее. Готовые архивы собирают отдельно для каждой версии Ghidra, сборка из исходников требует Gradle wrapper из репозитория и переменной GHIDRA_INSTALL_DIR.
• Потоковый HTTP поддерживает протокол 2025-11-25, SSE остается на 2024-11-05. Последняя редакция протокола 2026-07-28 пока не поддержана полностью: автор ждет следующей большой версии Java SDK.
• Инструменты импорта файла, экспорта программы и пять инструментов запуска скриптов выключены по умолчанию. Их включают флажками в окне настроек, и с этого момента сервер может принимать произвольные файлы и выполнять скрипты по запросу агента.
• Расширение разбирает чужие программы, поэтому применять его можно только к бинарным файлам, на анализ которых у вас есть разрешение.
• Закрытие проекта по умолчанию идет без сохранения, но сервер отказывается закрыть проект с несохраненными правками. Параметр discard_changes разрешает их потерять.

Как отключить. Выключите сервер переключателем в окне Window, GhidrAssistMCP. Чтобы убрать расширение совсем, откройте в Ghidra File, Install Extensions, снимите флажок у GhidrAssistMCP и перезапустите программу. После сборки из исходников удаляет расширение команда ./gradlew uninstallExtension, при закрытой Ghidra.

Коротко о README

В репозитории есть описание проекта с установкой из готового архива и сборкой из исходников, настройкой сервера и инструментов, запуском в безголовом режиме и таблицей инструментов по задачам. Отдельные разделы описывают общий для всех окон рабочий слой, поддержку версий протокола MCP, структуру исходников с примером нового инструмента, команды сборки Gradle, журналирование и частые неполадки. Подробный разбор перехода на версию 3.0.0 лежит в docs/modernization-review.md.