Repolode
svnscha

svnscha/mcp-windbg

AIアシスタントからWinDbg/CDB/KDを操作し、Windowsのクラッシュダンプを解析したり、ユーザーモードやカーネルのターゲットをデバッグしたりできるMCPサーバーです。

スター
1,660
フォーク
168
未解決の Issue
2
最終コミット
10 日前

これは何?

mcp-windbgは、WindowsデバッガーをラップするPython製のModel Context Protocolサーバーです。ユーザーモードのダンプやリモートターゲットにはcdb.exe、カーネルターゲットにはkd.exeを使用します。MCP対応クライアントからクラッシュダンプを開き、!analyze -v、スタック、モジュール、スレッドなどの自動トリアージ結果を取得した後、結果を確認しながら追加のデバッガーコマンドを実行できます。

ダンプ解析に加えて、TCP、名前付きパイプ、COM経由で稼働中のユーザーモードデバッグサーバーに接続でき、KDNET、名前付きパイプ、シリアル経由でカーネルターゲットにも接続できます。複数のセッションを同時に開き、セッションIDで指定できます。呼び出しごとのタイムアウトにより、時間のかかるライブコマンドをCTRL+BREAKで中断し、セッションを再同期できます。

ローカル利用向けのstdio、または別のマシンからデバッグホストを操作するためのstreamable HTTPサービスとして動作します。フィルタースクリプトを使って、ツールの引数や出力に含まれる機密データをマスキングできます。Windowsと、Debugging Tools for WindowsまたはMicrosoft Store版WinDbgが必要です。

主な機能

  • 01.dmp、.mdmp、.hdmp形式のクラッシュダンプを開き、1回の呼び出しで自動トリアージ結果を返します。
  • 02TCP、名前付きパイプ、COM経由でユーザーモードのcdbリモートデバッグサーバーに接続します。
  • 03kd.exeを使用し、KDNET、名前付きパイプ、シリアル経由でカーネルターゲットに接続します。
  • 04MCPクライアントから、開いているセッションで任意のWinDbg/KDコマンドを実行できます。
  • 05セッションIDで指定する複数の同時セッションに対応します。
  • 06stdioまたはstreamable HTTPのトランスポートと、データをマスキングするフィルタースクリプトを利用できます。

ユースケース

  • AIアシスタントを使い、クラッシュダンプからアクセス違反やハングの根本原因を特定する。
  • KDに対応したマシンで、カーネルのバグチェックを引き起こしたドライバーを調査する。
  • クラッシュダンプのフォルダーをトリアージし、共通する障害パターンを見つける。
  • HTTP経由で別のマシンからWindowsホストをデバッグする。

収録されている特集

トピック

#windbg#crash-dump#debugging#mcp#mcp-server#windows#kernel-debugging#copilot#copilot-chat#crash-reports

よくある質問

mcp-windbg とは?
AIアシスタントからWinDbg/CDB/KDを操作し、Windowsのクラッシュダンプを解析したり、ユーザーモードやカーネルのターゲットをデバッグしたりできるMCPサーバーです。 mcp-windbgは、WindowsデバッガーをラップするPython製のModel Context Protocolサーバーです。ユーザーモードのダンプやリモートターゲットにはcdb.exe、カーネルターゲットにはkd.exeを使用します。MCP対応クライアントからクラッシュダンプを開き、!analyze -v、スタック、モジュール、スレッドなどの自動トリアージ結果を取得した後、結果を確認しながら追加のデバッガーコマンドを実行できます。
mcp-windbg は無料で使えますか?ライセンスは?
mcp-windbg は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
mcp-windbg は今もメンテナンスされていますか?
活発にメンテナンス中。mcp-windbg の最終コミットは 2026年10月28日 です。
mcp-windbg は何に使えますか?
AIアシスタントを使い、クラッシュダンプからアクセス違反やハングの根本原因を特定する。 KDに対応したマシンで、カーネルのバグチェックを引き起こしたドライバーを調査する。 クラッシュダンプのフォルダーをトリアージし、共通する障害パターンを見つける。 HTTP経由で別のマシンからWindowsホストをデバッグする。
mcp-windbg はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/svnscha/mcp-windbg

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト