一个用于Hyper-V VM管理和来宾执行的MCP(模式上下文协议)服务器. 曝光用于 VM 生命周期、 检查站管理、 内核调试设置的 19个工具 (KDNET/KDCOM),通过 PowerShell Direct 的来宾文件传输/命令执行 (无需WinRM).

设计为与 kd- mcp 对齐, 包接 kd.exe 内核调试。 [[T1] 返回 a kernel_attach_string 您可以直接通过 kd- mcp 的工具 [T3] 。 从端到端的VM快照 KDNET配置 内核附加在一个工作流程中.

– – . . .

□ 要求

• Windows 10/11 Pro或具有超V功能的企业
• 第3.10号线+
• 运行服务器的进程必须提升(以管理员身份运行)或 用户账户必须是 Hyper-V 管理员 本地组的成员

– – . . .

□ 安装

从 GitHub 直接安装 :

安装 hyperv-mcp 控制台脚本并拉入 [[T5] 依赖 自动。

安装特定修改(立方或承诺):

QQ 设置来宾证书

[[T6]、[T7]和所有[T8]工具 通过 PowerShell Direct 连接 VM 来宾,并需要本地管理员证书。 把它们设为Env vars:

hyperv-mcp

An MCP (Model Context Protocol) server for Hyper-V VM management and guest execution. Exposes 19 tools for VM lifecycle, checkpoint management, kernel debug setup (KDNET/KDCOM), and guest file transfer/command execution via PowerShell Direct (no WinRM required).

Designed to pair with kd-mcp, which wraps kd.exe for kernel debugging. hyperv_configure_kdnet returns a kernel_attach_string you can pass directly to kd-mcp’s kernel_attach tool — end-to-end VM snapshot → KDNET config → kernel attach in one workflow.

---

Requirements

• Windows 10/11 Pro or Enterprise with Hyper-V enabled
• Python 3.10+
• The process running the server must be elevated (run as Administrator) or the user account must be a member of the Hyper-V Administrators local group

---

Installation

Install directly from GitHub:

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

This installs the hyperv-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]

Set guest credentials

hyperv_configure_kdnet, hyperv_configure_kdcom, and all hyperv_guest_* tools connect to VM guests via PowerShell Direct and need local admin credentials. Set them once as env vars:

$env:HYPERV_GUEST_USERNAME = "Administrator"
$env:HYPERV_GUEST_PASSWORD = "your_guest_password"

The hyperv_victim_* tools use a separate unprivileged account for EoP testing:

$env:HYPERV_GUEST_VICTIM_USERNAME = "victim"
$env:HYPERV_GUEST_VICTIM_PASSWORD = "your_victim_password"

---

Connecting to MCP clients

Claude Code (CLI)

claude mcp add hyperv -- hyperv-mcp

.mcp.json

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

If you need to pin guest credentials per-config:

{
  "mcpServers": {
    "hyperv": {
      "command": "hyperv-mcp",
      "env": {
        "HYPERV_GUEST_USERNAME": "Administrator",
        "HYPERV_GUEST_PASSWORD": "your_guest_password"
      }
    }
  }
}

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

python -m hyperv_mcp

---

Development install

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

---

Available Tools (19 total)

VM Lifecycle