Сервер MCP (Model Context Protocol) для управления виртуальной машиной Hyper-V и выполнения гостей. Выставляет 19 инструментов для жизненного цикла ВМ, управления контрольными точками, настройки отладки ядра (KDNET/KDCOM) и передача гостевых файлов через PowerShell Direct (не требуется WinRM).

Предназначен для сопряжения с kd-mcp, который обертывается [[Т0]] для отладки ядра. [[Т1]] возвращает kernel_attach_string Вы можете перейти непосредственно к инструменту kd-mcp kernel_attach —

end-to-end VM snapshot → KDNET config → ядро прикрепляется в одном рабочем процессе.

Требования

Windows 10/11 Pro или Enterprise с поддержкой Hyper-V Python 3.10+

• Процесс работы сервера ** должен быть повышен ** (запускается в качестве администратора) или Пользовательская учетная запись должна быть членом локальной группы Hyper-V Administrators

##Установка

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

Это приводит к тому, что hyperv-mcp, mcp, mcp, [[T]], [[T]], [[T]], [[T]], [[T]], [[T]]], [[T]], [[T]], [[T]]], [[T]], [[T]], [[T]]], [[T]], [[T]], [[T]], [[T]]], [[T]], [[T]], [[T]], [[T]]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]], [[ автоматически.

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

###Установка гостевых учетных данных

hyperv_configure_kdnet, hyperv_configure_kdcom и все hyperv_guest_* инструменты Подключайтесь к гостям VM через PowerShell Direct и нуждайтесь в учетных данных местного администратора. Поставьте их как 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