ctxdebug

WinDbg、IDA Pro、x64dbg 向け MCP サーバー
単一の stdio インターフェース · 160 以上のツール · 3 つのデバッガ、1 つのクライアント。

クイックスタート · アーキテクチャ · サーバー · ワークフロー · 問題を報告

ウェブサイト · ctxdebug.xyz  ·  お問い合わせ · [email protected]  ·  ステータス · パブリックアルファ

_{自身が所有する、または解析許可を得たシステムに対する、認可されたリバースエンジニアリング、クラッシュ解析、セキュリティリサーチ向けです。}

▎ 概要

ctxdebug は、WinDbg、IDA Pro 9.x、x64dbg を AI コーディングアシスタントに接続する MCP（Model Context Protocol）プラットフォームです。クラッシュダンプ解析、IDA での静的レビュー、x64dbg でのライブデバッグに利用できます — ウィンドウ間で出力をコピーする必要はありません。

単一の stdio インターフェース。160 以上のツール。 3 つのデバッガ、1 つのクライアント。

仕組み。 各デバッガは MCP ツールサーバーとして公開されます。Claude、Kiro、または任意の MCP 互換クライアントと対話し、クライアントがデバッガを呼び出します。コピー＆ペーストも、ツール間の手動での関連付けも不要です。

例。 「このクラッシュダンプを解析して根本原因を見つけて」 と尋ねると、ctxdebug は WinDbg でダンプを開き、!analyze -v を実行し、フォールトアドレスを取得して IDA Pro でその関数を逆コンパイルし、擬似コードとコールチェーンを含む統合レポートを返します。

▎ デモ

_{1 つのプロンプト → WinDbg がダンプを開き、クラッシュを解析し、IDA がフォールトした関数を逆コンパイル — 統合レポートを約 1.8 秒で生成。}

▎ クイックスタート

要件

• Python 3.11+
• OS Windows 10 / 11
• 少なくとも 1 つのデバッガ — WinDbg（Windows SDK）· IDA Pro 9.x · x64dbg

インストール

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

サーバーの登録

個別のサーバー:

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

または、統合ゲートウェイを使う — 1つのサーバーですべてのツールを利用できます:

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

完全な JSON 設定と環境変数については mcp_config_example.json を参照してください。

試してみる

サーバーが登録されたら、AI クライアントに次のように尋ねてください:

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

オーケストレーターは 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 バックエンド (Claude、Groq、OpenRouter、ローカル Ollama、またはヒューリスティックのみ) を備えた ReAct ループ
• セッション — FTS5、WAL モード、スレッドセーフな SQLite
• ゲートウェイ — サブサーバーを子プロセスとして起動し、単一の stdio 接続を通じてツール呼び出しをプロキシします

▎ サーバー

▎ デバッガのセットアップ

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

▎ 主要なワークフロー

クラッシュダンプ → ソース (1コマンド)

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

ダンプを開き、!analyze -v を実行し、フォールトアドレスを抽出し、IDA でクラッシュした関数を逆コンパイルし、呼び出し元を含む擬似コードを返します。

アンチ分析レポート

mco_bossix_report()
bossix_hide()            # PEB flag adjustments (lab)
bossix_patch(address)    # NOP / flip JCC at a check (lab)

アンチデバッグチェックを実装したサンプルの許可されたラボ分析向け。

アドレスを擬似コードにピボットする

mco_pivot_to_ida(address="0x7FF712340000")

ゴール駆動型分析

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

エージェントは一連のツール呼び出しを計画し、それらを実行して、LLMバックエンドの有無にかかわらず調査結果を報告します。

セッション記録

session_start(name="crash dump review")
# ... do your work ...
session_end(notes="null deref in CRenderObject::Destroy")
session_export_markdown(session_id=1)

▎ x64dbg サーバーモード

▎ 環境変数

▎ プロジェクト構成