ctxdebug

ЦЕНТР УПРАВЛЕНИЯ ДЛЯ РЕВЕРС-ИНЖИНИРИНГА
Один stdio-интерфейс · 160+ инструментов · Три отладчика, один центр управления.

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

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

_{Создан для авторизованного реверс-инжиниринга, отладки и исследований в области безопасности.}

▎ Обзор

ctxdebug — это MCP-серверная платформа, которая подключает WinDbg, IDA Pro 9.x и x64dbg к AI-ассистентам для написания кода для реверс-инжиниринга и исследования безопасности Windows.

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

Идея. MCO превращает ваши отладчики в серверы инструментов MCP (Model Context Protocol). Вы общаетесь с Claude, Kiro или любым MCP-совместимым клиентом — а он общается с вашими отладчиками. Никакого копирования вывода. Никакого переключения окон. Никакой ручной сверки данных между инструментами.

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

▎ Демо

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

▎ Последовательность запуска

T-2 — Требования

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

T-1 — Установка

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

T-0 — Регистрация серверов

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

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.

LIFTOFF — Проверка

После регистрации сервера задайте вашему AI-клиенту:

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

MCO автоматически связывает windbg_open_dump → windbg_analyze_crash → mco_pivot_to_ida и возвращает псевдокод с цепочкой вызовов.

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

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

• Транспорт — 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-подключение

▎ Флот — серверы

▎ Наземная подготовка — отладчики

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

▎ Ключевые рабочие процессы

Крах → исходный код (одна команда)

mco_crash_to_source(dump_path="C:\\dumps\\crash.dmp")

Открывает дамп, выполняет !analyze -v, извлекает адрес сбоя, декомпилирует аварийную функцию в IDA и возвращает псевдокод с вызывающими функциями.

Обнаружение и обход антиотладки

mco_bossix_report()
bossix_hide()            # PEB patch
bossix_patch(address)    # NOP / flip JCC at check

Переключение любого адреса на псевдокод

mco_pivot_to_ida(address="0x7FF712340000")

Автономный анализ по целям

agent_analyze(goal="Find the unpacking loop and identify the OEP")

Агент планирует последовательность вызовов инструментов, выполняет их и сообщает результаты — с LLM-бэкендом или без него.

Запись сессии

session_start(name="chrome uaf analysis")
# ... do your work ...
session_end(notes="UAF at CRenderObject::Destroy")
session_export_markdown(session_id=1)

▎ Режимы сервера x64dbg

▎ Переменные окружения

▎ Структура проекта

mco/
├── windbg_mcp.py           # WinDbg MCP server (production, 3000+ lines)
├── ida_mcp.py              # IDA Pro MCP server
├── ida_server_plugin.py    # IDA Python plugin (starts HTTP server)
├── mco_orchestrator.py     # Cross-debugger meta-tools
├── mco_sessions.py         # Session recording (SQLite + FTS5)
├── mco_gateway.py          # Unified gateway proxy
├── agent/
│   ├── __main__.py         # x64dbg MCP entry point + LLM backend selection
│   ├── core.py             # ReAct agent (Observe → Think → Act)
│   ├── memory.py           # Persistent memory store (~/.x64ai/)
│   ├── bridge.py           # Named-pipe IPC to x64dbg plugin
│   ├── mcp_server.py       # Tool definitions (38+)
│   ├── skills/             # Modular skill implementations
│   └── plugins/
│       ├── x64dbg_plugin.cpp
│       └── build_plugin.bat
├── mcp_config_example.json # Ready-to-use MCP client config
└── pyproject.toml

▎ Разработка

git clone https://github.com/DdUdle/ctxdebug.git
cd ctxdebug
pip install -e ".[dev]"
pytest

▎ Участие в разработке

Вклад приветствуется. Пожалуйста, откройте issue перед началом крупных изменений, чтобы сначала можно было обсудить подход.

▎ Лицензия

MIT — см. LICENSE.

_{Три отладчика. Один центр управления. Запуск разрешён. 🔥}