Hyper-V VM 管理およびゲスト実行用の MCP (Model Context Protocol) サーバー。 VM のライフサイクル、チェックポイント管理、カーネルのデバッグ設定のための 19 個のツールを公開 (KDNET/KDCOM)、PowerShell Directによるゲストファイル転送/コマンド実行 (WinRM不要)

ラップするkd-mcpとペアリングするように設計 カーネルデバッグ用の[kd.exe。 [hyperv_configure_kdnet]]]は、 [kernel_attach_string] kd-mcpの[kernel_attachツールに直接渡すことができます。 エンドツーエンド VM スナップショット → KDNET config → カーネルを 1 つのワークフローに添付します。

お問い合わせ

要件

• 有効なHyper-VのWindows 10/11のプロか企業
• Python 3.10 +
• サーバを実行しているプロセスが高まる(管理者として実行) ユーザーアカウントは、Hyper-V Administratorsローカルグループのメンバーでなければなりません

お問い合わせ

インストール

GitHubから直接インストールします。

これは[hyperv-mcp]コンソールスクリプトをインストールし、[mcp依存性をプルします 自動的に。

特定のリビジョン(タグまたはコミット)をインストールするには:

ゲスト資格情報を設定する

[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