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.8s में।}

▎ लॉन्च अनुक्रम

T-2 — आवश्यकताएँ

• Python 3.11+
• OS 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 संचार — localhost:2022 पर HTTP REST, 6 उम्मीदवारों से एंडपॉइंट स्वतः खोजता है
• x64dbg संचार — नेम्ड पाइप पर बाइनरी फ्रेमिंग (X64A मैजिक + uint32 लंबाई + 8-बाइट पैडिंग + JSON)
• एजेंट रीज़निंग — प्लगेबल LLM बैकएंड के साथ ReAct लूप (Claude, Groq, OpenRouter, स्थानीय Ollama, या केवल-ह्यूरिस्टिक्स)
• सत्र — FTS5 फुल-टेक्स्ट सर्च वाला SQLite, 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।

_{तीन डिबगर। एक मिशन कंट्रोल। **लॉन्च के लिए तैयार।** 🔥}