
x64dbg MCP: два сервера и подключение к Claude Code, Cursor и Codex
Даёт агенту управлять отладчиком x64dbg: ставить точки останова, шагать по коду, читать и патчить память, смотреть регистры, модули и стек вызовов.
Нативный плагин на Zig без зависимостей: сам поднимает HTTP-сервер внутри x64dbg с токеном Bearer, Python и .NET не нужны.
Как подключить
Что сделать до подключения
Скачать релиз и скопировать содержимое dist/ в корневую папку x64dbg: плагин встанет и в x32, и в x64
Запустить x64dbg: сервер стартует сам, x64 на порту 9094, x32 на 9095
Скопировать токен в Plugins → x64dbg-MCP Server → Configure MCP Server… кнопкой Copy
AuthorizationТокен создаётся при первом запуске; Plugins → x64dbg-MCP Server → Configure MCP Server… → Copy, новый — кнопкой Generate
Конфиг для вашего клиента
Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code
claude mcp add --transport http x64dbg http://localhost:9094/ \
--header 'Authorization: Bearer <токен из настроек плагина>'Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.x64dbg]
url = "http://localhost:9094/"
http_headers = { "Authorization" = "Bearer <токен из настроек плагина>" }Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"x64dbg": {
"url": "http://localhost:9094/",
"headers": {
"Authorization": "Bearer <токен из настроек плагина>"
}
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"x64dbg": {
"type": "http",
"url": "http://localhost:9094/",
"headers": {
"Authorization": "Bearer <токен из настроек плагина>"
}
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"x64dbg": {
"httpUrl": "http://localhost:9094/",
"headers": {
"Authorization": "Bearer <токен из настроек плагина>"
}
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"x64dbg": {
"httpUrl": "http://localhost:9094/",
"headers": {
"Authorization": "Bearer <токен из настроек плагина>"
}
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"x64dbg": {
"type": "remote",
"url": "http://localhost:9094/",
"headers": {
"Authorization": "Bearer <токен из настроек плагина>"
}
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
Customize → Connectors → добавить свой коннектор.
Адрес сервера: http://localhost:9094/
Request headers: Authorization: Bearer <токен из настроек плагина>Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"x64dbg": {
"url": "http://localhost:9094/",
"headers": {
"Authorization": "Bearer <токен из настроек плагина>"
}
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
LoadBinaryзагружает программу в отладчикAttachProcessподключается к процессу по PIDExecuteDebuggerCommandвыполняет команду x64dbgGetDebugStateпоказывает состояние отладкиDisassembleдизассемблирует инструкции по адресуDisassembleFunctionдизассемблирует функцию целикомReadMemoryвыводит память в hexWriteMemToAddressпатчит память байтамиSetBreakpointставит точку остановаSetHardwareBreakpointставит аппаратную точку остановаSetConditionalBreakpointставит точку с условиемrunпродолжает выполнениеStepOverшагает с обходом вызововGetAllRegistersвыводит все регистрыGetCallStackпоказывает стек вызововListModulesвыводит загруженные модулиFindPatternищет байтовый шаблонGetStringsизвлекает строки модуляDetectOEPищет OEP упакованного файлаDumpModuleсохраняет модуль в файлПоказано 20 из 80.
Плагин .dp64/.dp32 плюс мост на Python x64dbg.py, который клиент запускает по stdio; 56 инструментов поверх SDK x64dbg.
Как подключить
Что сделать до подключения
Скопировать .dp64 или .dp32 из build/release репозитория в [папка x64dbg]/release/x64/plugins/
Скачать src/x64dbg.py и поставить зависимости: pip install mcp requests
Запустить x64dbg и проверить в логах (Alt+L), что плагин загрузился
Конфиг для вашего клиента
Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code
claude mcp add --transport stdio x64dbgmcp \
-- python '<путь к x64dbg.py>'Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.x64dbgmcp]
command = "python"
args = ["<путь к x64dbg.py>"]Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"x64dbgmcp": {
"command": "python",
"args": ["<путь к x64dbg.py>"]
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"x64dbgmcp": {
"type": "stdio",
"command": "python",
"args": ["<путь к x64dbg.py>"]
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"x64dbgmcp": {
"command": "python",
"args": ["<путь к x64dbg.py>"]
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"x64dbgmcp": {
"command": "python",
"args": ["<путь к x64dbg.py>"]
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"x64dbgmcp": {
"type": "local",
"command": ["python", "<путь к x64dbg.py>"]
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
{
"mcpServers": {
"x64dbgmcp": {
"command": "python",
"args": ["<путь к x64dbg.py>"]
}
}
}Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"x64dbgmcp": {
"command": "python",
"args": ["<путь к x64dbg.py>"]
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
ExecCommandвыполняет команду x64dbgRegisterGetчитает регистрMemoryReadчитает памятьMemoryWriteпишет в памятьDebugRunпродолжает выполнениеDebugStepOverшагает с обходом вызововDebugSetBreakpointставит точку остановаPatternFindMemищет шаблон в памятиDisasmGetInstructionRangeдизассемблирует диапазонGetModuleListвыводит модулиXrefGetищет перекрёстные ссылкиGetCallStackпоказывает стек вызововLabelSetставит меткуCommentSetпишет комментарийMemoryBaseнаходит базу модуляПоказано 15 из 56.
Что попросить агента
Для каких задач
Ограничения
Сервер полностью управляет отладчиком, читает и пишет память процесса; duty1g по умолчанию слушает 0.0.0.0 по HTTP без шифрования — для работы только на своей машине поставьте 127.0.0.1
Только Windows: x64dbg и плагины собраны под него
У Wasdubya агент сможет перезапустить упавшую программу, только если вы дадите ему полный путь к exe
Инструменты для разбора чужих программ: пользуйтесь ими только там, где у вас есть право на анализ
Если не работает
Запросы к серверу duty1g получают 401 Unauthorized
Плагин Wasdubya не отвечает
Какую реализацию выбрать
| Реализация | Кто делает | Звёзды | Запуск | Ключ | Инструменты | Обновлён |
|---|---|---|---|---|---|---|
| x64dbg-MCP Server | duty1g | 2,8 тыс. | HTTP | токен | 80 | 3 ноября 2026 |
| x64dbg MCP | Wasdubya | 608 | локально | не нужен | 56 | 5 июня 2026 |