
Plataforma de engenharia reversa alimentada por MCP que conecta WinDbg, IDA Pro e x64dbg a 160+ ferramentas de depuração e análise acessíveis por IA.
Servidores MCP para WinDbg, IDA Pro e x64dbg
Uma interface stdio · 160+ ferramentas · Três depuradores, um cliente.
Início Rápido · Arquitetura · Servidores · Fluxos de Trabalho · Reportar um Problema
Site · ctxdebug.xyz · Contato · [email protected] · Status · Alfa público
Para engenharia reversa autorizada, análise de falhas e pesquisa de segurança em sistemas que você possui ou tem permissão para analisar.
ctxdebug é uma plataforma MCP (Model Context Protocol) que conecta WinDbg, IDA Pro 9.x e x64dbg a assistentes de codificação com IA. Use-a para análise de despejo de falhas, revisão estática no IDA e depuração ao vivo no x64dbg — sem copiar saída entre janelas.
Uma interface stdio. 160+ ferramentas. Três depuradores, um cliente.
Como funciona. Cada depurador é exposto como um servidor de ferramentas MCP. Você conversa com o Claude, Kiro ou qualquer cliente compatível com MCP; o cliente chama os depuradores. Sem copiar e colar, sem correlação manual entre ferramentas.
Exemplo. Você pergunta: "analise este despejo de falhas e encontre a causa raiz." O ctxdebug abre o despejo no WinDbg, executa
!analyze -v, obtém o endereço da falha, descompila a função no IDA Pro e retorna um relatório combinado com pseudocódigo e a cadeia de chamadas.
Um prompt → o WinDbg abre o despejo, analisa a falha, o IDA descompila a função com falha — relatório combinado em ~1,8s.
git clone https://github.com/DdUdle/ctxdebug.git
cd ctxdebug
pip install -e .
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 ver a configuração JSON completa com variáveis de ambiente.
Depois que um servidor estiver registrado, pergunte ao seu cliente de IA:
Open C:\dumps\crash.dmp, run a full crash analysis,
and decompile the function at the fault address.
O orquestrador encadeia windbg_open_dump → windbg_analyze_crash → mco_pivot_to_ida e retorna pseudocódigo com a cadeia de chamadores.
| Capacidade | O que faz |
|---|---|
| Controle de depurador ao vivo | Executa, pausa, avança passo a passo e inspeciona um processo através do x64dbg. Define breakpoints em grupos de API (memory, network, crypto) em vez de um endereço de cada vez. |
| Pivô entre depuradores | Pega um endereço de um crash dump do WinDbg e o abre no IDA Pro para descompilação, chamadores e chamados em uma única chamada de ferramenta. |
| Análise orientada a objetivos | O servidor x64dbg inclui um agente ReAct opcional (agent_analyze) que planeja objetivos de múltiplas etapas — por exemplo, encontrar um loop de unpacking ou listar verificações anti-análise — encadeando chamadas de ferramentas. Funciona com Claude, Groq, Ollama local ou apenas heurísticas. |
| Notas persistentes | O agente armazena assinaturas de packers, padrões anti-análise e notas de sessões anteriores, e pode recuperá-las em novos alvos. |
| Gravação de sessão | As chamadas de ferramentas podem ser registradas em SQLite com busca de texto completo (FTS5). Reproduza uma linha do tempo, compare duas sessões ou exporte um relatório em Markdown. |
| Levantamento anti-análise | Combina uma varredura estática (imports/padrões do IDA) e uma varredura dinâmica (PEB/RDTSC do x64dbg) em um único relatório. Patches de laboratório opcionais (flags do PEB, edições de instruções) para amostras que você está autorizado a analisar. |
2024-11-05)localhost:2022, descobre automaticamente o endpoint a partir de 6 candidatosX64A + comprimento uint32 + padding de 8 bytes + JSON)| Servidor | Arquivo | O que faz | Ferramentas |
|---|---|---|---|
windbg | windbg_mcp.py | Crash dumps, análise de heap, shadow stack, depuração de kernel | 70+ |
ida | ida_mcp.py | Descompilação, xrefs, recuperação de tipos, patching de binários | 32+ |
x64dbg | agent/ | Análise dinâmica, agente ReAct, inspeção e patching de memória | 38+ |
mco | mco_orchestrator.py | Fluxos de trabalho compostos entre depuradores | 7 |
mco-sessions | mco_sessions.py | Gravação de sessão, busca FTS, exportação em Markdown | 13 |
mco-gateway | mco_gateway.py | Proxy unificado — todos os servidores através de uma única conexão | todos |
Requer cdb.exe do Windows SDK. Caminho padrão:
C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\cdb.exe
Defina WINDBG_MCP_CDB se o seu caminho for diferente. Não é necessário pré-iniciar — as ferramentas abrem dumps ou anexam sob demanda.
Abra o IDA Pro 9.x com um binário carregado.
No console Python, execute:
exec(open(r'path\to\ctxdebug\ida_server_plugin.py').read())
O servidor HTTP inicia na porta 2022.
Descubra as ferramentas mais usadas pela nossa comunidade.
Sem dados de popularidade ainda.