vmware-fusion-mcp-server

VMware Fusion MCP Server

An MCP (Model Context Protocol) server that lets AI assistants manage VMware Fusion virtual machines on macOS via the vmrun command-line tool.

Prerequisites

• macOS with VMware Fusion (or Fusion Pro) installed
• Node.js >= 18
• The vmrun binary (bundled with VMware Fusion at /Applications/VMware Fusion.app/Contents/Library/vmrun)

Installation

cd vmware-fusion-mcp-server
npm install
npm run build

Configuration

Claude Desktop / Claude Code

Add this to your MCP settings (e.g. claude_desktop_config.json or .claude.json):

{
  "mcpServers": {
    "vmware-fusion": {
      "command": "node",
      "args": ["/path/to/vmware-fusion-mcp-server/dist/index.js"],
      "env": {}
    }
  }
}

Custom vmrun path

If VMware Fusion is installed in a non-standard location, set the VMRUN_PATH environment variable:

{
  "env": {
    "VMRUN_PATH": "/custom/path/to/vmrun"
  }
}

Available Tools

| Tool | Description | |------|-------------| | fusion_list_running | List all currently running VMs | | fusion_list_all | Discover all VMs on the system (scans common directories) | | fusion_get_vm_info | Get detailed info about a specific VM (OS, RAM, CPUs, IP) | | fusion_start_vm | Start (power on) a VM, optionally headless | | fusion_stop_vm | Stop a VM (soft/graceful or hard/forced) | | fusion_suspend_vm | Suspend a running VM to disk | | fusion_reset_vm | Reboot a VM (soft or hard) | | fusion_get_ip | Get the guest OS IP address | | fusion_list_snapshots | List all snapshots of a VM | | fusion_create_snapshot | Create a new snapshot | | fusion_revert_snapshot | Revert to a previous snapshot | | fusion_delete_snapshot | Delete a snapshot | | fusion_check_tools | Check VMware Tools status in the guest | | fusion_run_in_guest | Run a program inside the guest OS |

Example Usage

Once connected, you can ask your AI assistant things like:

• "List all my virtual machines"
• "Start my Ubuntu VM"
• "What's the IP address of my Windows VM?"
• "Create a snapshot called 'before-update' for my dev VM"
• "Stop all running VMs gracefully"

How It Works

The server wraps VMware Fusion's vmrun CLI utility and exposes its functionality as MCP tools. It automatically discovers VMs by scanning standard macOS VM directories (~/Virtual Machines.localized, etc.) and reads .vmx configuration files to extract VM metadata like display names, guest OS type, memory, and CPU count.

License

MIT