{ "name": "upload_file", "arguments": { "vm_name": "worker-node", "source": ".env.production", "destination": "/app/.env" } } ``` ### 10. Locate Error Logs > "Search for any files named `error.log` inside the `/var/log` directory." ```json { "name": "search_files", "arguments": { "vm_name": "monitor", "query": "error.log", "path": "/var/log" } } ``` ### 11. Setup File Watcher > "Configure a file sync. Map my local `./src` folder to `/usr/src/app` on 'dev-main'." ```json { "name": "configure_sync", "arguments": { "vm_name": "dev-main", "host_path": "./src", "guest_path": "/usr/src/app", "direction": "bidirectional" } } ``` ### 12. Conflict Resolution > "There's a sync conflict on README.md. Use my local version." ```json { "name": "resolve_conflict", "arguments": { "vm_name": "docs-site", "file_path": "README.md", "resolution": "use_host" } } ```

Observability Examples

### 13. Live Debugging > "Show me the last 50 lines of the nginx error log on the 'proxy' VM." ```json { "name": "tail_vm_log", "arguments": { "vm_name": "proxy", "path": "/var/log/nginx/error.log", "lines": 50 } } ``` ### 14. Monitor Background Task > "What is the output so far for task `task_12345`?" ```json { "name": "get_task_output", "arguments": { "vm_name": "data-lake", "task_id": "task_12345" } } ``` ### 15. Search Logs > "Search the syslog on 'auth-service' for any 'segfault' errors." ```json { "name": "grep_log_stream", "arguments": { "vm_name": "auth-service", "path": "/var/log/syslog", "pattern": "segfault" } } ```

Snapshot Examples

### 16. Pre-Update Backup > "I'm about to upgrade the database. Save a snapshot called 'before-v14-upgrade'." ```json { "name": "snapshot_save", "arguments": { "vm_name": "postgres-primary", "snapshot_name": "before-v14-upgrade" } } ``` ### 17. Disaster Recovery > "The upgrade failed! Restore to the 'before-v14-upgrade' snapshot." ```json { "name": "snapshot_restore", "arguments": { "vm_name": "postgres-primary", "snapshot_name": "before-v14-upgrade" } } ``` ### 18. List Snapshots > "What snapshots are available for the 'kafka-broker' VM?" ```json { "name": "snapshot_list", "arguments": { "vm_name": "kafka-broker" } } ```

Process Control Examples

### 19. Investigate High Load > "The 'ml-trainer' VM is slow. List the running processes." ```json { "name": "list_processes", "arguments": { "vm_name": "ml-trainer" } } ``` ### 20. Kill Stuck Process > "Process ID 9982 is stuck on 'worker-01'. Kill it." ```json { "name": "kill_process", "arguments": { "vm_name": "worker-01", "pid": 9982, "signal": "SIGKILL" } } ```

Network & Dashboard Examples

### 21. Check Service Availability > "Is port 8080 open and listening on the 'jenkins' VM?" ```json { "name": "check_vm_port", "arguments": { "vm_name": "jenkins", "guest_port": 8080 } } ``` ### 22. System Health Dashboard > "Get me a full dashboard with CPU, RAM, and disk usage." ```json { "name": "get_vm_dashboard", "arguments": { "vm_name": "production-replica" } } ```

Progress & Download Examples

### 23. Initiate Large Download > "Download the 10GB dataset from example.com to `/data/` on the 'ai-model' VM." ```json { "name": "start_download", "arguments": { "vm_name": "ai-model", "url": "http://example.com/data.tar.gz", "destination": "/data/data.tar.gz" } } ``` ### 24. Blocking Wait > "Wait for the download operation `op_5592` to finish." ```json { "name": "wait_for_operation", "arguments": { "operation_id": "op_5592", "timeout_seconds": 600 } } ```

System Maintenance Examples

### 25. Detect Zombie VMs > "Scan the system to see if we have any orphaned Zombie VMs." ```json { "name": "scan_system_health", "arguments": {} } ``` ### 26. Clean Zombies (Dry Run) > "Check what would happen if we cleaned up 'zombie-1' and 'old-test'." ```json { "name": "cleanup_zombies", "arguments": { "vm_names": ["zombie-1", "old-test"], "dry_run": true } } ```

--- ## ⚙️ MCP Configuration ### Claude Desktop / Cline / Cursor Add to your `claude_desktop_config.json` or `mcp_config.json`: ```json { "mcpServers": { "vagrant-mcp": { "command": "node", "args": ["C:\\path\\to\\Virtualbox-mcp-server\\apps\\mcp-server\\dist\\index.js"], "env": { "LOG_LEVEL": "info", "PATH": "C:\\Program Files (x86)\\Vagrant\\bin;C:\\Program Files\\Oracle\\VirtualBox;%PATH%" } } } }

Virtualbox MCP Server

Installation