virtualization-mcp

<p align="center"> <a href="https://github.com/casey/just"><img src="https://img.shields.io/badge/just-ready_to_go-7c5cfc?style=flat-square&logo=just&logoColor=white" alt="Just"></a> <a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff"></a> <a href="https://python.org"><img src="https://img.shields.io/badge/Python-3.13+-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python"></a> <a href="https://biomejs.dev"><img src="https://img.shields.io/badge/Linted_with-Biome-60a5fa?style=flat-square&logo=biome&logoColor=white" alt="Biome"></a> <a href="https://github.com/PrefectHQ/fastmcp"><img src="https://img.shields.io/badge/FastMCP-3.2-7c5cfc?style=flat-square" alt="FastMCP"></a> </p>

Spin up VMs, sandboxes, and dev environments — from your AI assistant.

A Model Context Protocol server that gives your AI (Claude Desktop, Cursor, etc.) direct control over VirtualBox, Hyper-V, and Windows Sandbox. Talk to your VMs, don't click through menus.

"create an Ubuntu VM, attach the 24.04 ISO, boot it, and set up port forwarding"
→ 30 seconds, all through chat

Quick Start

git clone https://github.com/sandraschi/virtualization-mcp
cd virtualization-mcp
just

This opens an interactive dashboard showing all available commands. Run just bootstrap to install dependencies, then just serve or just dev to start.

Manual Setup

If you don't have just installed:

What you get

Feature	What it does
VMs	Create, start, stop, pause, snapshot, delete — VirtualBox & Hyper-V
ISO pipeline	Download Ubuntu, Debian, Windows, Kali directly into assets/vbox
Console	VNC browser console via noVNC — see and interact with your VMs
Networking	NAT, Bridged, Host-Only, port forwarding — configure per VM
Unattended install	autoinstall.yaml / autounattend.xml with dev tools auto-setup
Templates	Save VM configs, recreate instantly
Windows Sandbox	Launch disposable sandbox with full dev stack (winget + pip + npm)
Fleet dashboard	Health-check and launch all registered MCP webapps

Documentation

• Installation & setup — prerequisites, config, start scripts
• Architecture — how it all fits together
• VirtualBox — VM lifecycle, networking, snapshots
• Hyper-V — Windows-native VM management
• Windows Sandbox — isolated dev environments
• Usage cases — real workflows and examples

Requirements

• Windows 11 Pro/Enterprise/Education (Hyper-V & Sandbox)
• VirtualBox 7.0+ with VBoxManage in PATH (for VirtualBox features)
• Python 3.12+ and Node 20+
• Ollama (optional) — local LLM for the chat feature

License

MIT — do what you want.