Virtualbox MCP Server

Create a new Vagrant VM

Get the status of a specific Vagrant VM

List all managed VMs and their statuses

Destroy a Vagrant VM (force)

Execute a shell command inside a VM

Upload a file from host to VM

Search for files inside the VM (using grep)

Configure file synchronization and watchers

Get the current alignment status of the sync engine

Resolve a file sync conflict

Create and configure a development VM with Vagrant (advanced)

Ensure development VM is running, create if it doesn't exist

Execute a command in the VM with file synchronization before and after

Run a command in the VM as a background task

Install language runtimes, tools, and dependencies in the VM

Install specific development tools in the VM

Configure shell environment in the VM

Sync files from host to VM

Sync files from VM to host

Reads the last N lines of a specific file inside the VM (e.g., /var/log/syslog, /var/log/nginx/error.log). Essential for debugging service failures.

Retrieves the stdout and stderr buffers of a specific background task started via run_background_task. Essential for monitoring long-running jobs.

Searches within a log file for a specific pattern. Locates events within active log streams.

Creates a lightweight Vagrant snapshot. Use before risky operations to enable rollback if something breaks.

Reverts the VM to a specific named snapshot. Enables rapid recovery without destroying and rebuilding the VM.

Lists all available snapshots for a VM.

Deletes a specific snapshot from a VM.

Returns a structured list of running processes in the VM (like ps aux). Use to verify service health and resource usage.

Sends a signal (SIGTERM/SIGKILL) to a specific process in the VM. Required to stop runaway tasks or stuck servers.

Verifies if a port is listening in the VM and optionally accessible from the host. Differentiates 'App failed' from 'Port forwarding failed'.

Returns a comprehensive dashboard with VM status, resource usage (CPU/RAM/Disk), active background tasks, and recent logs.

Starts a tracked file download operation. Returns an operation_id that MUST be used with `wait_for_operation`.

Gets real-time progress of a specific operation (bytes downloaded, percentage, ETA).

Blocks execution until an operation completes OR times out. CRITICAL: Use this after starting any long-running task.

Cancels a running operation.

Lists all currently running operations.

Checks system health (disk space, memory) and identifies potential 'Zombie' VMs. Can optionally perform a security scan on a specific VM.

Safely cleans up identified Zombie VMs. REQUIRES explicit list of VM names to avoid accidents.

A detailed tool for dynamic and reflective problem-solving. MUST be used between steps to analyze state. Features: Checks resources (RAM/Disk) before VM creation, verifies hypothesis, allows branching/backtracking. Parameters: - thought: The current thinking step. MUST include technical checks (e.…

Controls Headless vs GUI state of a VM.

Executes a command with auto-snapshot safety. Reverts on failure if rollback_on_fail is true.

Wait until a specific condition is met in the VM (port, file, log, or service).

Aggregates a diagnostic bundle (logs, processes, system state) for failure analysis.

Modifies VM CPU/RAM/GUI settings. Triggers a reboot if the VM is running.

Exports the VM to a portable .box file using `vagrant package`.

Securely injects environment variables into the VM's .profile. Parameters are redacted from MCP logs.

Scans the VM for common security issues (open ports, weak ssh config).