MCP Windbg

🚀 WinDbgクラッシュ解析用MCPサーバー

AIモデルとWinDbgを橋渡しし、クラッシュダンプ解析とリモートデバッグを行うためのModel Context Protocolサーバーです。

🚀 クイックスタート

前提条件

• Windows用デバッグツール または Microsoft StoreのWinDbg がインストールされたWindows。
• Python 3.10以上
• 任意のMCP互換クライアント（GitHub Copilot、Claude Desktop、Cline、Cursor、Windsurfなど）
• 選択したクライアントでMCPサーバーを設定する

⚠️ 重要提示

企業環境では、組織のポリシーによりMCPサーバーの使用が制限される場合があります。AIツールの使用についてITチームに確認し、必要な許可を取得してから進めてください。

インストール

pip install mcp-windbg

✨ 主な機能

概要

このMCPサーバーは CDB と統合されており、AIモデルがWindowsのクラッシュダンプを解析し、WinDbg/CDBを使用してリモートデバッグセッションに接続できるようになります。

これは何ですか？

LLMとWinDbgを橋渡しし、クラッシュダンプ解析とライブデバッグを行うAIパワードのツールです。"Show me the call stack and explain this access violation" のような自然言語クエリでデバッガーコマンドを実行できます。

これは何ではないか？

魔法のように自動修正するソリューションではありません。CDBをラップしたPythonツールで、LLMの知識を活用してデバッグを支援します。

使用モード

• クラッシュダンプ解析：Windowsのクラッシュダンプを調査します。
• ライブデバッグ：リモートデバッグターゲットに接続します。
• ディレクトリ解析：複数のダンプを処理してパターンを見つけます。

📦 インストール

トランスポートオプション

MCPサーバーは複数のトランスポートプロトコルをサポートしています。

異なるトランスポートでの起動

標準入出力 (デフォルト):

mcp-windbg
# または明示的に指定
mcp-windbg --transport stdio

ストリーミング可能なHTTP:

mcp-windbg --transport streamable-http --host 127.0.0.1 --port 8000

エンドポイント: http://127.0.0.1:8000/mcp

コマンドラインオプション

--transport {stdio,streamable-http}  トランスポートプロトコル (デフォルト: stdio)
--host HOST                              HTTPサーバーのホスト (デフォルト: 127.0.0.1)
--port PORT                              HTTPサーバーのポート (デフォルト: 8000)
--cdb-path PATH                          cdb.exeへのカスタムパス
--symbols-path PATH                      シンボルのカスタムパス
--timeout SECONDS                        コマンドのタイムアウト (デフォルト: 30)
--verbose                                詳細出力を有効にする

Visual Studio Codeの設定

MCPサーバーをすべてのワークスペースで使用できるようにするには、グローバルユーザー設定を使用します。

1. F1 を押し、> を入力して MCP: Open User Configuration を選択します。
2. 以下のJSONスニペットをユーザー設定に貼り付けます。

{
    "servers": {
        "mcp_windbg": {
            "type": "stdio",
            "command": "python",
            "args": ["-m", "mcp_windbg"],
            "env": {
                "_NT_SYMBOL_PATH": "SRV*C:\\Symbols*https://msdl.microsoft.com/download/symbols"
            }
        }
    }
}

これにより、ローカルの .vscode/mcp.json ファイルが不要になり、任意のワークスペースでMCP Windbgを使用できます。

HTTPトランスポートの設定

MCPサーバーを別途実行する必要があるシナリオ（リモートアクセス、共有サーバー、またはサーバー自体のデバッグなど）では、HTTPトランスポートを使用できます。

1. サーバーを手動で起動:

python -m mcp_windbg --transport streamable-http --host 127.0.0.1 --port 8000

2. VS CodeをHTTP経由で接続するように設定:

{
    "servers": {
        "mcp_windbg_http": {
            "type": "http",
            "url": "http://localhost:8000/mcp"
        }
    }
}

ワークスペース固有の設定と代替設定：Claude Desktop、Cline、その他のクライアントの設定方法や、ワークスペースのみの設定については、インストールドキュメント を参照してください。

設定が完了したら、MCPクライアントを再起動してデバッグを開始します。

Analyze the crash dump at C:\dumps\app.dmp

💻 使用例

クラッシュダンプ解析

Analyze this heap address with !heap -p -a 0xABCD1234 and check for buffer overflow" Execute !peb and tell me if there are any environment variables that might affect this crash" Run .ecxr followed by k and explain the exception's root cause"

リモートデバッグ

"Connect to tcp:Port=5005,Server=192.168.0.100 and show me the current thread state" "Check for timing issues in the thread pool with !runaway and !threads" "Show me all threads with ~*k and identify which one is causing the hang"

📚 ドキュメント

MCP互換性

このサーバーは Model Context Protocol (MCP) を実装しているため、MCP対応のクライアントと互換性があります。

MCPの魅力は、サーバーを一度書けばどこでも動作することです。好きなAIアシスタントを選んでください！

ツール

ドキュメント一覧

ブログ

開発の旅についてはこちらを読んでください: The Future of Crash Analysis: AI Meets WinDbg

リンク

• Reddit: I taught Copilot to analyze Windows Crash Dumps
• Hackernews: AI Meets WinDbg

スター履歴

📄 ライセンス

MIT