Skip to content
Back to search

windbg-ext-mcp

WinDbg-ext-MCP bridges your favorite LLM client (like Cursor, Claude, or VS Code) with WinDbg, enabling real-time, AI assisted kernel debugging. Write prompts in your AI coding assistant and receive instant, context-aware analysis and insights from your live kernel debugging session.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nadavlor--windbg-ext-mcp/badge.svg)](/listings/nadavlor--windbg-ext-mcp)

HTML

<a href="/listings/nadavlor--windbg-ext-mcp"><img src="/api/listings/nadavlor--windbg-ext-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prereqs - Windows 10/11 - WinDbg (Windows SDK “Debugging Tools for Windows”) - Visual Studio Build Tools (C++) - Python 3.10+ and Poetry 2.x

Build the extension (Developer PowerShell for VS):

msbuild extension\windbgmcpExt.sln /p:Configuration=Release /p:Platform=x64

Load in WinDbg:

.load C:\path\to\windbgmcpExt.dll

Install and run the MCP server (in root directory):

poetry install
poetry run selftest
poetry run mcp --list-tools
poetry run mcp

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 144 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # WinDbg‑ext‑MCP
  2. WinDbg extension + Python MCP server. Lets MCP‑compatible clients (Cursor, Claude, VS Code + Cline/Roo) drive WinDbg with clean, validated commands. Kernel‑first; user‑mode works too.
  3. ## Contents
  4. - Quick Start
  5. - Architecture
  6. - Usage Examples
  7. - What’s Here
  8. - Sanity Check
  9. - Troubleshooting
  10. - Configuration
  11. - Tested With
  12. - Notes
  13. ## Quick Start
  14. Prereqs
  15. - Windows 10/11
  16. - WinDbg (Windows SDK “Debugging Tools for Windows”)
  17. - Visual Studio Build Tools (C++)
  18. - Python 3.10+ and Poetry 2.x
  19. Build the extension (Developer PowerShell for VS):
  20. ```powershell
  21. msbuild extension\windbgmcpExt.sln /p:Configuration=Release /p:Platform=x64
  22. ```
  23. Load in WinDbg:
  24. ```text
  25. .load C:\path\to\windbgmcpExt.dll
  26. ```
  27. Install and run the MCP server (in root directory):
  28. ```powershell
  29. poetry install
  30. poetry run selftest
  31. poetry run mcp --list-tools
  32. poetry run mcp
  33. ```
  34. ## Architecture
  35. ```text
  36. MCP Client (stdio) <—> Python MCP Server (stdio) <—> WinDbg Extension (named pipe) <—> WinDbg/Target
  37. FastMCP \\.\pipe\windbgmcp Kernel/User
  38. ```
  39. - The extension hosts a named‑pipe server and executes WinDbg commands safely.
  40. - The Python server validates inputs, resolves timeouts, and exposes tools to MCP clients.
  41. ## Usage Examples
  42. General (natural language prompts)
  43. - "Show me all running processes in the kernel"
  44. - "What's the current thread's stack trace?"
  45. - "Analyze the memory at address 0x1000"
  46. - "Help me understand this crash dump"
  47. - "Set a breakpoint on nt!NtCreateFile and continue execution"
  48. - "Step through the next 3 instructions and show me the registers"
  49. Rootkit behavior (research‑only)
  50. - "Hide explorer.exe using EPROCESS unlink and PspCidTable Unlink"
  51. - "Make OneDrive.exe appear to have no open handles"
  52. - "Make notepad.exe resistance to termination and kill attempts"
  53. - "Install invisible system call hooks that dont modify SSDT"
  54. - "Hide network connections from netstat while keeping them active"
  55. - "Make files invisible to directory enumeration but accessible by direct path"
  56. Note: These are for lawful, defensive research in controlled test labs only.
  57. ## Available Tools
  58. - debug_session: session status and metadata
  59. - connection_manager: connection health and resilience controls
  60. - session_manager: capture/restore debugging context
  61. - run_command: execute a WinDbg command with validation/timeout handling
  62. - run_sequence: execute multiple commands in order
  63. - breakpoint_and_continue: set a breakpoint and continue execution
  64. - analyze_process: process enumeration, info, and context switching
  65. - analyze_thread: thread info and stack traces
  66. - analyze_memory: memory display, typed structures, searches
  67. - analyze_kernel: kernel objects and system analysis
  68. - performance_manager: optimization controls and performance report
  69. - async_manager: parallel execution and async task stats
  70. - troubleshoot: quick diagnostics and guidance
  71. - get_help: list tools and usage tips
  72. - test_windbg_communication: pipe connectivity test
  73. - network_debugging_troubleshoot: network debugging issue checks
  74. ## What’s Here
  75. - `extension/`: C++ WinDbg extension. Named pipe `\\.\pipe\windbgmcp`. Exports: `help`, `objecttypes`, `hello`, `mcpstart`, `mcpstop`, `mcpstatus`.
  76. - `mcp_server/`: Python MCP server using FastMCP with modular tools (session, execution, analysis, performance, support).
  77. - `install_client_config.py`: Optional helper to write MCP client configs (Cursor/Claude/VS Code).
  78. ## MCP Client Config (optional)
  79. Writes/updates MCP client configuration so your client can discover and launch this server.
  80. Supported clients
  81. - Cursor, Claude Desktop, VS Code (Cline / Roo Code), Windsurf (Codeium)
  82. Commands (run from repo root)
  83. ```powershell
  84. # Dry run (preview changes)
  85. python install_client_config.py --install --dry-run
  86. # Install configs for detected clients
  87. python install_client_config.py --install
  88. # Uninstall (revert changes)
  89. python install_client_config.py --uninstall
  90. # Self-test only (no writes)
  91. python install_client_config.py --test
  92. ```
  93. Notes
  94. - The script detects your OS and only touches clients it finds installed.
  95. - It uses your current Python (`sys.executable`) to run the server and writes a stdio MCP config.
  96. - Install mode runs a quick server import test first; fix any errors before proceeding.
  97. ## Sanity Check (no target required)
  98. Self‑test stubs the transport and validates the protocol.
  99. ```powershell
  100. poetry run selftest
  101. ```
  102. Expected: “Selftest OK”.
  103. ## Troubleshooting
  104. - Extension won’t load:
  105. - Path or arch mismatch. Use x64 WinDbg with the x64 DLL.
  106. - If linking fails, install Windows SDK Debugging Tools.
  107. - Pipe connection errors:
  108. - The extension hosts the server. Ensure it’s started (`mcpstart`) and `\\.\pipe\windbgmcp` exists.
  109. - Slow/spotty results:
  110. - Fix symbol paths, bump timeouts for remote/VM targets, and scope commands.
  111. ## Configuration
  112. - `DEBUG=true` enables verbose logs in the Python server.
  113. - Timeouts auto‑resolve per command type. See `mcp_server/config.py` for categories.
  114. ## Tested With
  115. - Windows 11, MSVC v143, Windows SDK 10.0.22621.0
  116. - Python 3.13, Poetry 2.1
  117. - FastMCP 2.5.1, pywin32 310
  118. ## Notes
  119. - Build the DLL, run the server, load the extension. If WinDbg can’t load, the path is wrong or the arch doesn’t match. Fix that first.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.