mcp-virtualbox

Virtualbox MCP Server

mcp-virtualbox lets AI clients manage VirtualBox machines through screenshots, keyboard and mouse input, and guest command execution. It serves developers testing installers, working with legacy operating systems, or preparing cross-OS environments.

Server facts

mcp-virtualbox

Project

Author
chryaner
License
Not specified

Tech

Runtime / language
Not specified
Transports
stdio
Remote available
No
Authentication
Not specified

Activity

GitHub stars
4
Last commit
Data as of

Tags

  • virtualbox
  • vm

Overview

VirtualBox setup and guest interaction sit alongside each other in mcp-virtualbox: an AI client can create a machine, attach installation media, inspect its display, and send clicks or keystrokes through an installer. Creation tools expose memory, processor, disk, and controller choices, with OS-specific defaults and IDE selection for older systems that lack AHCI drivers. Installation guides provide operating-system-specific steps and settings. Other tools cover machine status, startup and shutdown, pausing, resets, snapshots, configuration changes, and deletion, supporting workflows such as testing a Windows installer or preparing a legacy Linux build environment.

Once a guest is running, command execution can move to SSH for Linux, WinRM for Windows, or Guest Additions. Guest Additions also support copying files between host and guest and are required for shared folders. Network tools retrieve guest IP addresses, wait for connectivity, and configure NAT forwarding; another tool waits for Guest Additions readiness. The project uses stdio and requires VirtualBox 7.x, Node.js 18+, and an installer ISO supplied by the user.

mcp-virtualbox setup notes

  • mcp-virtualbox records stdio only; confirm a network transport upstream before planning remote access.
  • mcp-virtualbox has no recorded license; confirm reuse terms in its repository.

Related MCP servers