ddudle/ctxdebugPiattaforma di reverse engineering basata su MCP che collega WinDbg, IDA Pro e x64dbg con oltre 160 strumenti di debug e analisi accessibili tramite IA.
Server MCP per WinDbg, IDA Pro e x64dbg
Un'unica interfaccia stdio · Oltre 160 strumenti · Tre debugger, un solo client.
Avvio rapido · Architettura · Server · Flussi di lavoro · Segnala un problema
Sito web · ctxdebug.xyz · Contatti · [email protected] · Stato · Alpha pubblica
Per reverse engineering autorizzato, analisi dei crash e ricerca sulla sicurezza su sistemi di tua proprietà o per i quali hai l'autorizzazione all'analisi.
ctxdebug è una piattaforma MCP (Model Context Protocol) che collega WinDbg, IDA Pro 9.x e x64dbg agli assistenti AI per la programmazione. Usala per l'analisi dei crash dump, la revisione statica in IDA e il debug live in x64dbg — senza copiare output tra le finestre.
Un'unica interfaccia stdio. Oltre 160 strumenti. Tre debugger, un solo client.
Come funziona. Ogni debugger è esposto come server di strumenti MCP. Parli con Claude, Kiro o qualsiasi client compatibile con MCP; il client chiama i debugger. Niente copia-incolla, nessuna correlazione manuale tra gli strumenti.
Esempio. Chiedi: "analizza questo crash dump e trova la causa principale." ctxdebug apre il dump in WinDbg, esegue
!analyze -v, prende l'indirizzo che ha causato il fault, decompila la funzione in IDA Pro e restituisce un report combinato con lo pseudocodice e la catena dei chiamanti.
Un solo prompt → WinDbg apre il dump, analizza il crash, IDA decompila la funzione che ha causato il fault — report combinato in ~1,8s.
git clone https://github.com/DdUdle/ctxdebug.git
cd ctxdebug
pip install -e .
Server singoli:
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
Oppure usa il gateway unificato — un solo server, tutti gli strumenti:
claude mcp add mco-gateway -- python mco_gateway.py
Consulta mcp_config_example.json per la configurazione JSON completa con le variabili d'ambiente.
Una volta registrato un server, chiedi al tuo client AI:
Open C:\dumps\crash.dmp, run a full crash analysis,
and decompile the function at the fault address.
L'orchestratore concatena windbg_open_dump → windbg_analyze_crash → mco_pivot_to_ida e restituisce lo pseudocodice con la catena dei chiamanti.
| Capacità | Cosa fa |
|---|---|
| Controllo del debugger live | Esegue, mette in pausa, esegue passo-passo e ispeziona un processo tramite x64dbg. Imposta breakpoint su gruppi di API (memory, network, crypto) invece che su un singolo indirizzo alla volta. |
| Pivot tra debugger | Prende un indirizzo da un crash dump di WinDbg e lo apre in IDA Pro per decompilazione, chiamanti e chiamati in un'unica chiamata allo strumento. |
| Analisi guidata da obiettivi | Il server x64dbg include un agente ReAct opzionale (agent_analyze) che pianifica obiettivi multi-step — ad esempio individuare un loop di unpacking o elencare i controlli anti-analisi — concatenando chiamate agli strumenti. Funziona con Claude, Groq, Ollama locale o solo con euristiche. |
| Note persistenti | L'agente memorizza firme dei packer, pattern anti-analisi e note delle sessioni precedenti, e può richiamarle su nuovi target. |
| Registrazione delle sessioni | Le chiamate agli strumenti possono essere registrate in SQLite con ricerca full-text (FTS5). Riproduci una timeline, confronta due sessioni o esporta un report Markdown. |
| Rilevamento anti-analisi | Combina una scansione statica (import/pattern di IDA) e una scansione dinamica (PEB/RDTSC di x64dbg) in un unico report. Patch di laboratorio opzionali (flag PEB, modifiche alle istruzioni) per i campioni che sei autorizzato ad analizzare. |
2024-11-05)localhost:2022, rileva automaticamente l'endpoint tra 6 candidatiX64A + lunghezza uint32 + padding di 8 byte + JSON)| Server | File | Cosa fa | Strumenti |
|---|---|---|---|
windbg | windbg_mcp.py | Crash dump, analisi dell'heap, shadow stack, debug del kernel | 70+ |
ida | ida_mcp.py | Decompilazione, xref, recupero dei tipi, patching dei binari | 32+ |
x64dbg | agent/ | Analisi dinamica, agente ReAct, ispezione e patching della memoria | 38+ |
mco | mco_orchestrator.py | Workflow composti tra debugger | 7 |
mco-sessions | mco_sessions.py | Registrazione delle sessioni, ricerca FTS, esportazione Markdown | 13 |
mco-gateway | mco_gateway.py | Proxy unificato — tutti i server attraverso un'unica connessione | tutti |
Richiede cdb.exe dal Windows SDK. Percorso predefinito:
C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\cdb.exe
Imposta WINDBG_MCP_CDB se il tuo percorso è diverso. Non è necessario alcun pre-avvio — gli strumenti aprono i dump o si collegano su richiesta.
Apri IDA Pro 9.x con un binario caricato.
Nella console Python, esegui:
exec(open(r'path\to\ctxdebug\ida_server_plugin.py').read())
Il server HTTP si avvia sulla porta 2022.