svnscha/mcp-windbg

何を解決するか

AIモデルが自然言語を使ってWindowsのクラッシュダンプ分析、ユーザーモードリモートデバッグ、カーネルデバッグを実行できるようにします。複雑なデバッガー コマンドを手動で実行する代わりに、ユーザーはLLMにアクセス違反の調査、バグチェックドライバーの特定、複数のクラッシュダンプのトリアージを依頼できます。

動作方法

このプロジェクトは、Pythonで構築されたModel Context Protocol (MCP) サーバーであり、Windowsデバッグツール cdb.exe（ユーザーモード用）および kd.exe（カーネルモード用）をラップする役割を果たします。LLMがセッションを開き、任意のデバッガー コマンドを実行し、結果の出力をもとに推論できるよう、一連のツールを公開しています。セッションIDを用いて複数の同時セッションをサポートでき、stdioまたはHTTP経由で動作可能です。

対象ユーザー

クラッシュの原因究明、ドライバーのデバッグ、ライブプロセス状態の確認が必要だが、AIを活用してトリアージと分析プロセスを自動化したいWindows開発者およびシステムエンジニア。

主な特徴

• 包括的なデバッグサポート：クラッシュダンプ（.dmp、.mdmp、.hdmp）、ライブユーザー モードリモートデバッグ、およびKDNET、名前付きパイプ、シリアル経由のカーネルデバッグを対応。
• 自然言語インターフェース：ユーザーのプロンプトに基づき、!analyze -v や kb などのコマンドをLLMが実行可能。
• セッション管理：複数の独立したデバッグセッションを同時にサポート。
• データプライバシー：--filter-script を通じてテキストフィルター フックを提供し、AIモデルに送信する前にPIIやシークレットをマスク可能。
• 信頼性の高いライブセッション：コールごとのタイムアウトを実装し、ハングしたセッションをCTRL+BREAKで再同期可能。