Virtualization

Spin up VMs, sandboxes, and dev environments from Claude Desktop, Cursor, or the fleet webapp.

Features

• VirtualBox & Hyper-V — create, start, stop, snapshot, clone VMs
• Windows Sandbox — consumer (nearly naked) and dev-infra bringups for fleet install testing
• ISO pipeline — download Ubuntu, Debian, Windows ISOs into assets/vbox
• noVNC console — browser VM console from the webapp
• Unattended Win11 — autoinstall with optional dev tools (dev VMs only)
• Fleet dashboard — health-check and launch registered MCP webapps

Quick Install

1. Download virtualization-mcp-*.mcpb from Releases
2. Drag into Claude Desktop

Other methods: INSTALL.md

What You Can Do

Create an Ubuntu 24.04 VM with 8 GB RAM and attach the ISO from assets.

Launch a consumer Windows Sandbox so I can test a naked INSTALL.md walkthrough.

Restore snapshot clean-base on NakedWin11 before the next install test.

Documentation

Doc	Contents
Installation	Options A–D, sandbox launchers
Configuration	Env vars, VirtualBox paths
Development	just, tests, mcpb build
Troubleshooting	Common errors
VirtualBox	VM lifecycle, snapshots
Windows Sandbox	Consumer vs dev bringup
Architecture	System design

Requirements

• Windows 11 Pro/Enterprise/Education for Hyper-V and Windows Sandbox
• VirtualBox 7+ with VBoxManage on PATH (VM features)
• Python 3.12+ — only for Options C/D

License

MIT