x64dbg MCP
x64dbg MCP Server Plugin
Плагин отладчика x64dbg и x32dbg с MCP-сервером на 79 инструментов и 11 командами Claude Code для разбора сбоев, трассировки и дампа памяти
- 534 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Управляет отладчиком: запускает программы, останавливает процессы, читает память и регистры
- Если включить права в config.json, агент пишет в память и регистры и выполняет сценарии отладчика
- Сервер можно открыть для сети, а проверка по токену по умолчанию выключена
Установка
- Работает в
Ручная установка
/install-plugin path/to/x64dbg-mcp/skillsУстанавливает 11 команд и навык `x64dbg-reverse-engineering` из склонированного репозитория. Сервер плагина отладчика должен уже работать.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Управляет отладчиком: запускает программы, останавливает процессы, читает память и регистры
- Если включить права в config.json, агент пишет в память и регистры и выполняет сценарии отладчика
- Сервер можно открыть для сети, а проверка по токену по умолчанию выключена
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Плагин на C++ загружается в отладчик x64dbg или x32dbg и запускает внутри него HTTP-сервер MCP, по умолчанию на `127.0.0.1:3000`. Агент подключается по адресу `/mcp` (потоковый HTTP) или `/sse` (прежний SSE) и получает 79 инструментов: запуск и остановка отлаживаемой программы, пошаговое выполнение, точки останова обычные, аппаратные, по памяти, условные и с записью в журнал, чтение и запись регистров и памяти, дизассемблирование, символы, модули, потоки, стек, закладки и выражения. Отдельная группа делает дамп модуля, определяет точку входа и упаковщик, а также снимает и сравнивает снимки состояния. Кроме инструментов сервер отдает 7 ресурсов (состояние отладчика, регистры, модули, потоки, карта памяти, точки останова, стек) и 8 шаблонов ресурсов, а также 10 готовых промптов. В каталоге `skills` лежит плагин для Claude Code с навыком `x64dbg-reverse-engineering` и 11 командами: `/debug-session`, `/analyze-crash`, `/unpack`, `/trace-function`, `/find-vuln`, `/reverse-algo`, `/api-monitor`, `/patch-code`, `/hunt-strings`, `/compare-state` и `/dump-memory`. Каждая команда ведет агента по фазам, вызывая нужные инструменты по порядку.
Для кого. Для разработчиков под Windows, исследователей безопасности и аналитиков, которые отлаживают собственные или разрешенные к анализу программы и хотят поручить агенту рутину в x64dbg.
Подходит, если
- Программа падает, и нужно найти причину по адресу сбоя: стек вызовов, регистры и дизассемблер вокруг инструкции
- Надо проследить вызов функции, записать аргументы в журнал точки останова и сравнить состояние до и после
- Требуется дамп модуля из памяти работающего процесса для дальнейшего разбора в другом инструменте
- Нужно журналировать вызовы API Windows группами: процессы, сеть, файлы
- Нужно найти в процессе строки и ссылки на них, чтобы быстро выйти на нужный участок кода
Не подходит, если
- Работаете на macOS или Linux: плагин собирается и работает только на Windows 10 и 11 внутри x64dbg
- Анализируете чужую программу, на разбор которой нет разрешения владельца или лицензии
- Нужен статический разбор и декомпиляция без запуска программы: для этого есть ghidramcp
- Нужно, чтобы с одним отладчиком работали сразу несколько агентов: плагин принимает одно клиентское подключение
- Нужен другой плагин для того же отладчика, тоже на Windows: его описывает карточка x64dbg-mcp-server
Пример запроса к агенту
Программа упала по адресу 0x401000. Останови ее на этой точке, покажи стек вызовов и регистры, а потом разбери, какая инструкция читает неверный адресMCP
- Транспорт
- http, sse
- Авторизация
- не нужна
Ограничения
Это инструмент двойного назначения: отладчик дает полный контроль над запущенным процессом, и применять его можно только к системам и данным, на которые у вас есть разрешение.
Сборка требует CMake 3.15 или новее, Visual Studio 2022 с рабочей нагрузкой для C++ и vcpkg. Нужен x64dbg или x32dbg сборки 2023 года и новее, а плагины `.dp64` и `.dp32` нельзя менять местами.
Сервер по умолчанию слушает `127.0.0.1`, а проверка по токену выключена (`auth_enabled: false`). Запись в память, запись в регистры и выполнение сценариев отключены в `config.json`, зато изменение точек останова разрешено. Для доступа из локальной сети в настройках меняют адрес на `0.0.0.0` и задают списки разрешенных источников и узлов.
Операции требуют, чтобы отладчик стоял на паузе. Сервер запускается из меню плагина вручную, если не включен автозапуск `auto_start_mcp_on_plugin_load`. Лицензия MIT.
Как отключить. Остановите сервер в меню отладчика Plugins, MCP Server и удалите файл плагина `x64dbg_mcp.dp64` или `x32dbg_mcp.dp32` из каталога `plugins`. Затем уберите блок `x64dbg` из конфигурации клиента, а плагин Claude Code отключите командами менеджера плагинов.
Частые вопросы
Как подключить агента к плагину?
Запустите сервер из меню x64dbg: Plugins, MCP Server, Start MCP HTTP Server. В клиенте укажите тип `http` и адрес `http://127.0.0.1:3000/mcp`, а для старых клиентов тип `sse` и адрес `http://127.0.0.1:3000/sse`.
Как установить плагин Claude Code с командами?
Склонируйте репозиторий и в Claude Code выполните `/install-plugin path/to/x64dbg-mcp/skills`. Другой путь — скопировать каталог `skills` в `.claude/plugins/x64dbg-re` или запустить `claude --plugin-dir path/to/x64dbg-mcp/skills`.
Какие права на запись выключены по умолчанию?
Запись в память (`allow_memory_write`), запись в регистры (`allow_register_write`) и выполнение сценариев (`allow_script_execution`). Изменение точек останова разрешено. Список разрешенных методов в примере ограничен группами `debug.*` и `memory.*`.
Как открыть сервер для другого компьютера или виртуальной машины?
Измените адрес на `0.0.0.0`, внесите источник клиента в `origin_allowlist`, а имя или адрес сервера в `host_allowlist`, включите `auth_enabled` с длинным токеном и перезапустите сервер. Для выхода в интернет авторы советуют обратный прокси с TLS и проверкой доступа, а не прямую публикацию порта.
Что делает команда /unpack?
Она ведет агента по трем фазам: анализ упакованного файла по энтропии секций и числу импортов, поиск точки входа оригинальной программы и сохранение дампа через `dump_module`. Результат проверяют повторным анализом дампа.
Где настройки хранятся и как их менять?
В файле `config.json` рядом с плагином. Править его можно и без ручной работы с JSON: пункт Plugins, MCP Server, Edit Config открывает редактор с разделами сервера, безопасности, прав, выполнения и журнала. После сохранения сервер перезапускают.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыНативный MCP-плагин для отладчика x64dbg: агент управляет отладкой по HTTP, ставит точки останова, шагает по коду, читает и патчит память
Официальный MCP-сервер Hex-Rays: агент открывает базы IDA, выполняет в них Python и разбирает бинарники. Плагины есть для Claude Code и Codex
Расширение Ghidra с MCP-сервером: агент читает псевдокод и дизассемблер, строит графы вызовов и правит имена, типы и структуры через 100 инструментов
MCP-Shield находит конфигурации MCP, подключается к серверам и ищет в описаниях инструментов скрытые команды, каналы утечки и подмену чужих инструментов
MCP-сервер к дизассемблеру Ghidra: сотни инструментов для обратной разработки, декомпиляция, переименование, работа со структурами, эмуляция и отладка
MCP-сервер и плагин для Ghidra: агент декомпилирует бинарники, смотрит перекрестные ссылки и переименовывает функции в открытом проекте
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| x64dbg MCP (эта запись) | нет | не нужна | 534 | |
| x64dbg-MCP Server | нет | API-ключ | 2 591 | другой плагин для x64dbg, на Zig, с токеном и портами 9094 и 9095 по умолчанию |
| GhidraMCP | нет | не нужна | 11 491 | MCP-сервер для Ghidra: статический разбор и декомпиляция бинарников без запуска программы |
Коротко о README
В репозитории описаны возможности сервера, сборка двух вариантов плагина скриптом `build.bat` и вручную через CMake, копирование файлов в каталоги отладчика и запуск из меню. Подробно разобраны файл `config.json`, редактор настроек, режимы доступа с одного компьютера, из локальной сети и через интернет, а также типичные причины отказа соединения. Есть список методов JSON-RPC, пример клиента на Python в каталоге `examples`, руководство на китайском и описание плагина Claude Code с примерами для анализа вредоносных программ и поиска уязвимостей.