ctxdebug — MCP-серверы для WinDbg, IDA Pro и x64dbg

MCP-серверы для WinDbg, IDA Pro и x64dbg
Единый stdio-интерфейс · 160+ инструментов · Три отладчика, один клиент.

Быстрый старт · Архитектура · Серверы · Рабочие процессы · Сообщить о проблеме

Сайт · ctxdebug.xyz · Контакты · [email protected] · Статус · Публичная альфа

_{Для авторизованного обратного проектирования, анализа сбоев и исследований в области безопасности на системах, которыми вы владеете или которые вам разрешено анализировать.}

▎ Обзор

ctxdebug — это платформа MCP (Model Context Protocol), которая подключает WinDbg, IDA Pro 9.x и x64dbg к ИИ-ассистентам для программирования. Используйте её для анализа дампов сбоев, статического анализа в IDA и живой отладки в x64dbg — без копирования вывода между окнами.

Один stdio-интерфейс. 160+ инструментов. Три отладчика, один клиент.

Как это работает. Каждый отладчик представлен как сервер инструментов MCP. Вы общаетесь с Claude, Kiro или любым MCP-совместимым клиентом; клиент вызывает отладчики. Никакого копирования и вставки, никакого ручного сопоставления данных между инструментами.

Пример. Вы спрашиваете: «проанализируй этот дамп сбоя и найди первопричину». ctxdebug открывает дамп в WinDbg, выполняет !analyze -v, берёт адрес сбоя, декомпилирует функцию в IDA Pro и возвращает объединённый отчёт с псевдокодом и цепочкой вызовов.

▎ Демонстрация

демонстрация ctxdebug — анализ дампа сбоя с WinDbg и IDA в одном запросе

_{Один запрос → WinDbg открывает дамп, анализирует сбой, IDA декомпилирует функцию сбоя — объединённый отчёт за ~1,8 с.}

▎ Быстрый старт

Требования

Python 3.11+
ОС Windows 10 / 11
Как минимум один отладчик — WinDbg (Windows SDK) · IDA Pro 9.x · x64dbg

Установка

git clone https://github.com/DdUdle/ctxdebug.git
cd ctxdebug
pip install -e .

Регистрация серверов

Отдельные серверы:

claude mcp add windbg       -- python windbg_mcp.py
claude mcp add ida          -- python ida_mcp.py
claude mcp add x64dbg       -- python -m agent --mcp
claude mcp add mco          -- python mco_orchestrator.py
claude mcp add mco-sessions -- python mco_sessions.py

Или используйте единый шлюз — один сервер, все инструменты:

claude mcp add mco-gateway -- python mco_gateway.py

Полный пример JSON-конфигурации с переменными окружения см. в mcp_config_example.json.

Попробуйте

После регистрации сервера спросите своего AI-клиента:

Open C:\dumps\crash.dmp, run a full crash analysis,
and decompile the function at the fault address.

Оркестратор выстраивает цепочку windbg_open_dump → windbg_analyze_crash → mco_pivot_to_ida и возвращает псевдокод с цепочкой вызывающих функций.

▎ Возможности

Возможность	Что делает
Управление живым отладчиком	Запуск, пауза, пошаговое выполнение и инспекция процесса через x64dbg. Установка точек останова на группы API (`memory`, `network`, `crypto`) вместо одного адреса за раз.
Переход между отладчиками	Взять адрес из дампа падения WinDbg и открыть его в IDA Pro для декомпиляции, просмотра вызывающих и вызываемых функций за один вызов инструмента.
Анализ, управляемый целью	Сервер x64dbg включает опционального ReAct-агента (`agent_analyze`), который планирует многошаговые цели — например, поиск цикла распаковки или перечисление проверок на антианализ — путём связывания вызовов инструментов. Работает с Claude, Groq, локальным Ollama или только с эвристиками.
Постоянные заметки	Агент сохраняет сигнатуры упаковщиков, шаблоны антианализа и заметки из предыдущих сессий и может вспоминать их на новых целях.
Запись сессий	Вызовы инструментов могут логироваться в SQLite с полнотекстовым поиском (FTS5). Воспроизведите временную шкалу, сравните две сессии или экспортируйте отчёт в Markdown.
Обзор антианализа	Объединяет статическое сканирование (импорты/шаблоны IDA) и динамическое сканирование (PEB/RDTSC x64dbg) в один отчёт. Опциональные лабораторные патчи (флаги PEB, правки инструкций) для образцов, которые вы уполномочены анализировать.

▎ Архитектура

Архитектура системы — одно MCP-соединение с тремя отладчиками, оркестратором и слоем сессий

Транспорт — stdio JSON-RPC (MCP 2024-11-05)
IDA — HTTP REST на localhost:2022, автоматически обнаруживает эндпоинт из 6 кандидатов
x64dbg — бинарная кадрировка через именованный канал (магия X64A + длина uint32 + 8-байтовое выравнивание + JSON)
Агент — цикл ReAct со сменными бэкендами LLM (Claude, Groq, OpenRouter, локальный Ollama или только эвристики)
Сессии — SQLite с FTS5, режим WAL, потокобезопасность
Шлюз — запускает подсерверы как дочерние процессы и проксирует вызовы инструментов через одно stdio-соединение

▎ Серверы

Сервер	Файл	Что делает	Инструменты
`windbg`	`windbg_mcp.py`	Дампы падений, анализ кучи, теневой стек, отладка ядра	70+
`ida`	`ida_mcp.py`	Декомпиляция, перекрёстные ссылки, восстановление типов, патчинг бинарников	32+
`x64dbg`	`agent/`	Динамический анализ, ReAct-агент, инспекция и патчинг памяти	38+
`mco`	`mco_orchestrator.py`	Составные рабочие процессы между отладчиками	7
`mco-sessions`	`mco_sessions.py`	Запись сессий, поиск FTS, экспорт в Markdown	13
`mco-gateway`	`mco_gateway.py`	Унифицированный прокси — все серверы через одно соединение	все

▎ Настройка отладчика

WinDbg

Требуется cdb.exe из Windows SDK. Путь по умолчанию:

C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\cdb.exe

Задайте WINDBG_MCP_CDB, если ваш путь отличается. Предварительный запуск не требуется — инструменты открывают дампы или подключаются по запросу.

IDA Pro 9.x

Откройте IDA Pro 9.x с загруженным бинарным файлом.

В консоли Python выполните:

exec(open(r'path\to\ctxdebug\ida_server_plugin.py').read())

HTTP-сервер запускается на порту 2022.

x64dbg

Соберите плагин на C++:
```
cd agent\plugins
build_plugin.bat
```

ctxdebug

Популярное