ctxdebug

CONTROLE DE MISSÃO PARA ENGENHARIA REVERSA
Uma interface stdio · 160+ ferramentas · Três depuradores, um controle de missão.

Início Rápido · Arquitetura · Servidores · Fluxos de Trabalho · Reportar um Problema

Site · ctxdebug.xyz  ·  Contato · [email protected]  ·  Status · Alfa público

_{Feito para engenharia reversa autorizada, depuração e pesquisa de segurança.}

▎ Visão Geral

ctxdebug é uma plataforma de servidores MCP que conecta WinDbg, IDA Pro 9.x e x64dbg a assistentes de codificação de IA para engenharia reversa e pesquisa de segurança no Windows.

Uma interface stdio. 160+ ferramentas. Três depuradores, um controle de missão.

A ideia. O MCO transforma seus depuradores em servidores de ferramentas MCP (Model Context Protocol). Você conversa com Claude, Kiro ou qualquer cliente compatível com MCP — e ele conversa com seus depuradores. Sem copiar e colar a saída. Sem alternar entre janelas. Sem correlação manual de dados entre ferramentas.

Uma única ida e volta. Você diz "analise este dump de crash e encontre a causa raiz." O MCO abre o dump no WinDbg, executa !analyze -v, extrai o endereço da falha, alterna para o IDA Pro para descompilar a função que causou o crash e retorna um relatório combinado com pseudocódigo e cadeia de chamadores.

▎ Demonstração

_{Um prompt → WinDbg abre o dump, analisa o crash, alterna para o IDA e retorna a origem da falha — causa raiz em ~1,8s.}

▎ Sequência de Lançamento

T-2 — Pré-requisitos

• Python 3.11+
• SO Windows 10 / 11
• Pelo menos um depurador — WinDbg (Windows SDK) · IDA Pro 9.x · x64dbg

T-1 — Instalação

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

T-0 — Registrar servidores

Servidores individuais:

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

Ou use o gateway unificado — um servidor, todas as ferramentas:

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

Consulte mcp_config_example.json para obter a configuração JSON completa com variáveis de ambiente.

LIFTOFF — Teste

Depois que um servidor for registrado, peça ao seu cliente de IA:

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

O MCO encadeia windbg_open_dump → windbg_analyze_crash → mco_pivot_to_ida automaticamente e retorna pseudocódigo com a cadeia de chamadores.

▎ Recursos

▎ Arquitetura

• Transporte — stdio JSON-RPC (especificação MCP 2024-11-05)
• Comunicação com o IDA — REST HTTP para localhost:2022, descobre automaticamente o endpoint entre 6 candidatos
• Comunicação com o x64dbg — enquadramento binário via named pipe (magic X64A + comprimento uint32 + padding de 8 bytes + JSON)
• Raciocínio do agente — loop ReAct com backends LLM plugáveis (Claude, Groq, OpenRouter, Ollama local ou apenas heurísticas)
• Sessões — SQLite com busca em texto completo FTS5, modo WAL, thread-safe
• Gateway — inicia sub-servidores como processos filhos, faz proxy de todas as chamadas de ferramentas por meio de uma única conexão stdio

▎ Frota — Servidores

▎ Configuração Base — Depuradores

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

▎ Fluxos de Trabalho Principais

Crash → código-fonte (um único comando)

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

Abre o dump, executa !analyze -v, extrai o endereço da falha, descompila a função que causou o crash no IDA e retorna pseudocódigo com os chamadores.

Detecção e bypass de anti-debug

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

Converta qualquer endereço em pseudocódigo

mco_pivot_to_ida(address="0x7FF712340000")

Análise autônoma orientada a objetivos

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

O agente planeja uma sequência de chamadas de ferramentas, as executa e relata as descobertas — com ou sem um backend LLM.

Gravação de sessões

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

▎ Modos do Servidor x64dbg

▎ Variáveis de Ambiente

▎ Estrutura do Projeto

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

▎ Desenvolvimento

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

▎ Contribuindo

Contribuições são bem-vindas. Por favor, abra uma issue antes de iniciar mudanças grandes para que a abordagem possa ser discutida primeiro.

▎ Licença

MIT — consulte LICENSE.

_{Três depuradores. Um controle de missão. Prontos para o lançamento. 🔥}