MCP(Model Context Protocol) 서버는 Hyper-V VM 관리 및 게스트 실행을 위한 서버입니다. VM 수명주기, 체크포인트 관리, 커널 디버그 설정을위한 19 도구 노출 (KDNET/KDCOM) 및 PowerShell Direct를 통한 게스트 파일 전송/컴맨드 실행 (필수).

포장하는 kd-mcp로 쌍에 디자인하는 kd.exe 커널 디버깅의 경우. hyperv_configure_kdnet 반환 kernel_attach_string kd-mcp의 kernel_attach] 도구에 직접 전달할 수 있습니다. end-to-end VM snapshot → KDNET config → 커널을 하나의 워크플로우에 연결합니다.

---

요구 사항

• Windows 10/11 Pro 또는 Hyper-V 활성화
• 파이썬 3.10+
• 서버**must를 실행하는 프로세스는 ** ( Administrator로 실행) 또는 사용자 계정은 Hyper-V Administrators 로컬 그룹 회원이어야 합니다.

---

설치

GitHub에서 직접 설치:

이것은 hyperv-mcp] 콘솔 스크립트를 설치하고 mcp 의존성을 끌어 자동.

특정 개정 (tag 또는 커밋)을 설치하려면:

게스트 자격 설정

hyperv_configure_kdnet, hyperv_configure_kdcom], 모든 hyperv_guest_*] 도구 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