MCP Windbg

🚀 WinDbg崩潰分析的MCP服務器

這是一個模型上下文協議（MCP）服務器，它將AI模型與WinDbg連接起來，用於崩潰轉儲分析和遠程調試。它可以幫助開發者更高效地分析Windows系統的崩潰問題，藉助AI的能力，通過自然語言查詢執行調試命令。

🚀 快速開始

前提條件

• 安裝了 Windows調試工具 或從 Microsoft Store下載WinDbg 的Windows系統。
• Python 3.10 或更高版本。
• 任何兼容MCP的客戶端（如GitHub Copilot、Claude Desktop、Cline、Cursor、Windsurf等）。
• 在所選客戶端中配置MCP服務器。

⚠️ 重要提示

在企業環境中，MCP服務器的使用可能會受到組織政策的限制。在繼續操作之前，請與您的IT團隊核實AI工具的使用情況，並確保您擁有必要的權限。

安裝

pip install mcp-windbg

✨ 主要特性

• 作為一個由AI驅動的工具，它將大語言模型（LLMs）與WinDbg連接起來，用於崩潰轉儲分析和即時調試。
• 支持通過自然語言查詢執行調試命令，例如 "Show me the call stack and explain this access violation"。
• 不是一個神奇的自動修復解決方案，而是一個基於Python封裝的CDB工具，利用大語言模型的知識輔助調試。
• 支持多種使用模式：
  • 崩潰轉儲分析：檢查Windows崩潰轉儲文件。
  • 即時調試：連接到遠程調試目標。
  • 目錄分析：處理多個轉儲文件以查找模式。
• 支持多種傳輸協議：
  • stdio（默認）：標準輸入/輸出，適用於本地MCP客戶端，如VS Code、Claude Desktop。
  • streamable-http：支持流式傳輸的HTTP協議，適用於具有雙向流功能的現代HTTP客戶端。

📦 安裝指南

不同傳輸方式啟動服務

標準輸入輸出（默認）

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兼容性

該服務器實現了 模型上下文協議（MCP），因此與任何支持MCP的客戶端兼容。MCP的優勢在於，只需編寫一次服務器，就可以在任何地方使用。您可以選擇自己喜歡的AI助手！

工具列表

📄 許可證

本項目採用MIT許可證。

🌟 其他信息

博客文章

閱讀開發歷程：崩潰分析的未來：AI與WinDbg的結合

相關鏈接

• Reddit: 我教會了Copilot分析Windows崩潰轉儲文件
• Hackernews: AI與WinDbg的結合

星標歷史