Обертывание сервера MCP (Model Context Protocol) kd.exe для отладки ядра Windows. Spawns kd.exe является подпроцессом и раскрывает его функциональность как 22 инструмента MCP. Обрабатывает соединения KDNET, точки останова, считывание памяти, проверку регистрации и символ разрешение без ограничений резьбы оберток DbgEng COM.

Предназначен для сопряжения с гиперv-mcp, Управление виртуальными машинами Hyper-V и настройка KDNET внутри гостей через PowerShell Прямой. Используйте hyperv-mcp, чтобы сделать снимок виртуальной машины и настроить KDNET, а затем пропустите [[Т2]], [[Т3]], [[Т4]], [[Т4]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], [[Т]], Сеанс отладки ядра.

Требования

Windows 10/11 с установленными инструментами отладки Windows Python 3.10+ Ядро-мишень, подключенное через KDNET

##Установка

Установить непосредственно с GitHub:

Это устанавливает консольный скрипт kd-mcp и автоматически втягивает зависимость mcp.

Установить конкретный пересмотр (метка или обязательство):

kd.exe местоположение

Сервер по умолчанию:

Переопределить с переменной среды KD_EXE, если она установлена в другом месте:

##Подключение к MCP-клиентам

###Клод Код (CLI)

.mcp.json

Если вам нужно установить KD_EXE per-config:

kd-mcp

An MCP (Model Context Protocol) server wrapping kd.exe for Windows kernel debugging. Spawns kd.exe as a subprocess and exposes its functionality as 22 MCP tools. Handles KDNET connections, breakpoints, memory reads, register inspection, and symbol resolution without the threading limitations of DbgEng COM wrappers.

Designed to pair with hyperv-mcp, which manages Hyper-V VMs and configures KDNET inside guests via PowerShell Direct. Use hyperv-mcp to snapshot a VM and set up KDNET, then pass the resulting kernel_attach_string to kd-mcp’s kernel_attach to drop into a kernel debug session.

---

Requirements

• Windows 10/11 with Windows Debugging Tools installed
• Python 3.10+
• A target kernel connected over KDNET

---

Installation

Install directly from GitHub:

pip install git+https://github.com/originsec/kd-mcp.git

This installs the kd-mcp console script and pulls in the mcp dependency automatically.

To install a specific revision (tag or commit):

pip install git+https://github.com/originsec/[email protected]

kd.exe location

The server defaults to:

C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\kd.exe

Override with the KD_EXE environment variable if installed elsewhere:

$env:KD_EXE = "C:\path\to\kd.exe"

---

Connecting to MCP clients

Claude Code (CLI)

claude mcp add kd -- kd-mcp

.mcp.json

{
  "mcpServers": {
    "kd": {
      "command": "kd-mcp"
    }
  }
}

If you need to pin KD_EXE per-config:

{
  "mcpServers": {
    "kd": {
      "command": "kd-mcp",
      "env": { "KD_EXE": "C:\\path\\to\\kd.exe" }
    }
  }
}

You can also invoke the module directly without the console script:

python -m kd_mcp

---

Development install

git clone https://github.com/originsec/kd-mcp.git
cd kd-mcp
pip install -e .

---

Available Tools (21 total)

Session

kernel_attach — Launches kd.exe and connects via KDNET. Auto-respawns kd.exe on connection failures until timeout expires, so it can catch the KDNET hello packet whenever the target becomes ready (e.g. after a VM reboot). Pass reset_vm with a Hyper-V VM name to hard-reset the VM 2 seconds after kd.exe starts.

connect_string format: "net:port=50000,key=a1b2.c3d4.e5f6.a7b8.c9d0"

Execution Control