x64dbg-MCP Server связывает отладчик x64dbg с ИИ-ассистентом: вы описываете задачу словами, а ассистент вызывает команды отладчика через MCP. Плагин пригодится, если вы разбираете работу исполняемого файла и хотите запрашивать регистры, память или точки останова в диалоге, не переключаясь каждый раз на ручное управление.
Как x64dbg-MCP Server передаёт команды от ассистента в отладчик
x64dbg — программа для отладки исполняемых файлов. Она позволяет останавливать выполнение, проходить код по инструкциям и смотреть состояние процесса. x64dbg-MCP Server устанавливается как плагин внутри отладчика и открывает его функции для MCP-клиента через HTTP. MCP — протокол, по которому ассистент обращается к внешним инструментам; если вы только знакомитесь с ним, начните с разбора что такое MCP и как подключить сервер.
По запросу ассистент может загрузить файл, поставить точку останова, продолжить выполнение или пройти инструкцию. Точка останова — место в коде, где отладчик приостанавливает программу. Плагин также позволяет читать регистры — ячейки процессора с текущими значениями — и память запущенного процесса. Он не только показывает данные: среди доступных действий есть изменение регистра, запись байтов в память и выполнение команды x64dbg.
Для анализа кода в README перечислены дизассемблирование, поиск строк и последовательностей байтов, просмотр модулей, потоков и стека вызовов. Дизассемблирование показывает машинные инструкции в читаемом виде; стек вызовов помогает увидеть, какие функции привели программу к текущему месту. Есть и работа с PE — структурой исполняемых файлов, включая разделы и точку входа. Часть команд доступна только во время активной отладки.
Плагин сообщает ассистенту о событиях отладчика: например, о срабатывании точки останова, исключении или загрузке библиотеки. Это помогает строить последовательность действий: запустить программу, дождаться остановки, затем прочитать состояние. README расходится сам с собой в числе инструментов: раздел возможностей обещает 84 MCP-инструмента, а раздел со списком говорит о 72. Рассчитывать на точное число до проверки установленной версии не стоит.
Кому пригодится диалог с x64dbg, а кому — нет
Первый случай — вы исследуете исполняемый файл и постоянно повторяете одну цепочку действий: загрузить его, остановить в нужном месте, получить регистры и посмотреть память. В README показано, как ассистент вызывает соответствующие инструменты по нескольким текстовым запросам. Это способ управлять уже открытым отладчиком через диалог, а не замена самому x64dbg.
Второй случай — вы изучаете поведение программы на разных шагах выполнения. Ассистент может пройти несколько инструкций, запросить стек вызовов или сведения о потоках. Если вы строите такие цепочки с помощью ИИ-агента, важно понимать: агент получит не только данные для ответа, но и возможность менять ход отладки.
Третий случай — вы работаете с MCP-совместимым клиентом, например в сценариях вокруг Claude Code, и хотите добавить к нему отладчик как внешний инструмент. Однако README не даёт отдельной процедуры настройки для конкретной версии Claude Code. Ориентируйтесь на формат конфигурации вашего клиента, а не считайте приведённый ниже файл универсальной настройкой для всех ассистентов.
Если вы не отлаживаете исполняемые файлы в x64dbg, плагин вам не нужен. Он также не добавляет отладку в обычный чат сам по себе: нужен запущенный x64dbg и MCP-клиент, способный подключаться к серверу. Это не навык для Claude или другого агента, который можно применить без доступа к отладчику.
Установка плагина и подключение MCP-клиента
README предлагает скачать готовый выпуск на странице релизов либо собрать плагин из исходников. Для готового выпуска перенесите содержимое каталога из инструкции в корневую папку x64dbg, затем запустите отладчик. Содержимое рассчитано сразу на обе версии — x32 и x64:
dist/
├── x32/
│ └── plugins/
│ └── x64dbg-MCP-Server.dp32
└── x64/
└── plugins/
└── x64dbg-MCP-Server.dp64Сервер стартует вместе с x64dbg. Указанные в README адреса и порты различаются по разрядности: для x64 — 0.0.0.0:9094, для x32 — 0.0.0.0:9095. Адрес 0.0.0.0 означает прослушивание всех сетевых интерфейсов; это существенная настройка, а не просто вариант записи адреса localhost.
При первом запуске плагин создаёт токен доступа. Откройте в меню Plugins > x64dbg-MCP Server > Configure MCP Server... и скопируйте его кнопкой Copy. В конфигурации MCP-клиента README показывает такой вариант для x64 и транспорта Streamable HTTP:
{
"mcpServers": {
"x64dbg": {
"type": "http",
"url": "http://localhost:9094/",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}Замените YOUR_TOKEN_HERE скопированным токеном. В README среди возможных мест для такой настройки назван .mcp.json, но точный файл зависит от MCP-клиента. Для клиентов, которым нужен прежний транспорт SSE, автор приводит адрес http://localhost:9094/sse и значение "type": "sse". Streamable HTTP и SSE здесь — два способа обмена сообщениями между клиентом и плагином.
Если вы собираете плагин сами, README требует Zig 0.16-dev или более позднюю версию и даёт одну команду. Сборка предусмотрена на Windows, WSL, Linux или macOS; результат затем нужно скопировать в папку x64dbg так же, как готовый выпуск.
zig build -Doptimize=ReleaseSafe --prefix distЧетыре запроса из примера README
Пример автора начинается с запроса Load calc.exe and break at the entry point. По схеме из README ассистент вызывает LoadBinary, SetBreakpoint, run и WaitForPause: загружает программу, ставит точку останова у входа и ждёт, пока выполнение там остановится. Показанный в примере адрес — иллюстрация ответа, а не значение, которое вы обязаны получить.
Далее пользователь спрашивает What are the current registers?. Ассистент вызывает GetAllRegisters и возвращает значения вроде RAX, RCX и RDX. Запрос Read 64 bytes at the current instruction pointer вызывает ReadMemory: в ответе показаны байты по адресу текущей инструкции, записанные в шестнадцатеричном виде.
Последний запрос в примере — Step over the next 3 instructions and show me the stack. Ассистент трижды вызывает StepOver, затем GetCallStack. «Пройти с обходом» означает выполнить следующую инструкцию, не заходя внутрь вызванной функции; стек после этого показывает цепочку вызовов в новой точке остановки. Все четыре реплики взяты из сценария README, который демонстрирует ожидаемый ход работы, а не проверенный результат на вашем компьютере.
Доступ к памяти, сетевой адрес и состояние проекта
До подключения клиента проверьте, какой доступ вы ему даёте. Плагин может читать и менять память процесса, управлять выполнением, сохранять дампы в файлы и запускать команды отладчика. Bearer-токен обязателен для каждого запроса; README сообщает, что запрос без действительного токена получает 401 Unauthorized. Токен можно заменить кнопкой Generate в окне настроек.
Токен не шифрует соединение: сервер работает по HTTP. Автор прямо предупреждает не открывать его для недоверенных сетей. Если удалённое подключение не требуется, в настройках предусмотрен адрес 127.0.0.1 для доступа только с этого компьютера. Для WSL или удалённой машины README предлагает адрес хоста и привязку к 0.0.0.0; выбирайте её только понимая, кому доступен этот сетевой интерфейс. Настройки сохраняются в mcp_config.json рядом с исполняемым файлом x64dbg.
Проект создан 22 августа 2026 года; на момент обзора последний коммит датирован 12 октября 2026 года, у репозитория 2615 звёзд и 295 форков. Лицензия — MIT. Для готового плагина README не требует Python, .NET или отдельную среду выполнения; Zig нужен, если вы собираете исходники. Требование к подписке на ИИ-сервис или отдельному API-ключу в README не указано, но нужен совместимый MCP-клиент. Если у вас уже есть x64dbg и задача по анализу программы, начните с локального подключения и решите, готовы ли вы дать ассистенту полный контроль над отладчиком.
Источник: репозиторий duty1g/x64dbg-mcp-server.