Mcp Virtualbox
@chryaner
About Mcp Virtualbox
Let AI see, click, type, and fully operate virtual machines
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"mcp-virtualbox": {
"command": "npx",
"args": [
"-y",
"mcp-virtualbox"
]
}
}
}Tools
30List all VirtualBox VMs with their state
Get detailed VM info
Create a new VM with OS type, RAM, disk, CPU, controllers, and USB tablet mouse. Auto-detects legacy OS types (WindowsXP, Windows2000, DOS, etc.) and uses IDE instead of SATA since they lack AHCI drivers. Defaults for RAM/CPU/disk are chosen based on OS type if not specified.
Start a VM
Stop a VM
Delete a VM and optionally all its files (disks, snapshots, etc.)
Pause a running VM
Resume a paused VM
Hard reset a running VM (like pressing the reset button)
Add a shared folder between host and guest. Requires Guest Additions in the guest. The folder appears as a network drive in Windows guests or can be mounted in Linux guests.
Remove a shared folder from a VM
Attach ISO/disk to VM, eject media, or attach Guest Additions ISO. For legacy OS VMs (XP, 2000, etc.) ISO goes on IDE port 1 device 0. For modern OS VMs, ISO goes on IDE port 0 device 0.
Manage VM snapshots
Modify arbitrary VM settings via VBoxManage modifyvm
List available OS type IDs for VM creation
Take a screenshot of the VM display, returns as image. Use this in a vision loop during OS installation: screenshot → analyze → send input → repeat.
Get VM display resolution and settings
Send named key combinations as PS/2 scancodes (e.g. 'enter', 'ctrl+alt+delete', 'f8', 'tab'). Use this for special keys, shortcuts, and navigation.
Type printable text string into the VM (uses keyboardputstring). For special keys use vm_keyboard_scancode instead.
Click at absolute screen coordinates (requires USB tablet mouse mode, enabled by vm_create). Coordinates match screenshot pixel positions. Uses Python VirtualBox API helper.
Execute a command inside the guest via Guest Additions (no network required). Guest Additions must be installed and running.
Copy a file from host to guest via Guest Additions
Copy a file from guest to host via Guest Additions
Execute a command on a Linux guest via SSH
Execute a command on a Windows guest via WinRM (SOAP/HTTP, Basic auth)
Get the guest IP address via VirtualBox guest properties
Wait until Guest Additions are running (polls GuestAdditionsRunLevel)
Wait until the guest has a valid IP address
Add a NAT port forwarding rule to the VM
Get OS-specific installation guide with step-by-step instructions, gotchas, and recommended settings. Call this BEFORE starting an OS installation to avoid common pitfalls. Available guides: windowsxp, windows7, windows10, windows11, ubuntu, linux
Overview
What is Mcp Virtualbox?
Mcp Virtualbox is an MCP server that gives AI full control over VirtualBox virtual machines through 30 tools and two operating modes. It lets an AI see, click, type, and operate VMs from bare‑metal OS installation to daily use, without human intervention.
How to use Mcp Virtualbox?
Install via Claude Code using /plugin marketplace add chryaner/mcp-virtualbox and /plugin install mcp-virtualbox@mcp-virtualbox, or configure manually by adding the server to your MCP settings with npx -y mcp-virtualbox. The server requires VirtualBox 7.x and Node.js 18+, and you must provide your own OS installer ISO.
Key features of Mcp Virtualbox
- Two modes: Vision loop and Text mode
- Vision loop takes screenshots and sends keyboard/mouse input
- Text mode uses SSH, WinRM, or Guest Additions for commands
- 30 tools for full VirtualBox control
- Installs any OS from an ISO without scripting
- Works with legacy operating systems (CentOS 6, Windows XP, 2000)
- Creates disposable VMs for untrusted files
Use cases of Mcp Virtualbox
- Install any OS from an ISO – AI clicks through the entire installer
- Test an app’s installer on a clean Windows machine
- Compile code on legacy Linux (e.g., CentOS 6)
- Run legacy software that needs old Windows (XP, 2000)
- Create disposable VMs for untrusted files
FAQ from Mcp Virtualbox
What does Mcp Virtualbox do that alternatives don’t?
It combines vision‑based interaction (screenshots + keyboard/mouse) with text‑mode automation (SSH, WinRM, Guest Additions) to give AI full control over VirtualBox VMs – from OS installation to daily operation.
What are the system requirements?
VirtualBox 7.x and Node.js 18+ are required. You must provide your own OS installer ISO.
How do I install Mcp Virtualbox?
You can install it via Claude Code using the plugin marketplace commands or manually by adding the server configuration to your MCP settings.
What are the two operating modes?
Vision loop takes screenshots of the VM screen and sends keyboard/mouse input. Text mode switches to SSH, WinRM, or Guest Additions for fast command execution once the OS is running.
Can I install an OS from an ISO automatically?
Yes – the AI can click through the entire operating system installer, no scripting needed.
More Other MCP servers
MCP Go 🚀
mark3labsA Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.
Activepieces
activepiecesAI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
MaxKB
1Panel-dev🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。
IDA Pro MCP
mrexodiaAI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.
ICSS
chokcoco不止于 CSS
Comments