Skip to content

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

9 Commits

Folders and files

Repository files navigation

VMware Workstation MCP Server

A Model Context Protocol server for VMware Workstation. Control virtual machines from AI assistants like Claude Code via the vmrun CLI.

Features

  • VM lifecycle (start, stop, restart)
  • Snapshots (create, restore, list, delete)
  • File transfer (host <-> guest)
  • Run commands and scripts in guest
  • Process management, screen capture, IP lookup

Requirements

  • Python 3.10+
  • VMware Workstation Pro (with vmrun in PATH or configured path)
  • VMware Tools installed in guest VMs

Quick Start

With Claude Code

claude mcp add --transport stdio vmware -- \
  uvx --from git+https://github.com/slupro/vmware-mcp.git vmware-mcp \
  --config ~/vmware-mcp.json

Or install from source:

pip install git+https://github.com/slupro/vmware-mcp.git
claude mcp add --transport stdio vmware -- vmware-mcp --config ~/vmware-mcp.json

Configuration

Create a config.json (see config.example.json):

{
  "vmrun_path": "C:\\Program Files (x86)\\VMware\\VMware Workstation\\vmrun.exe",
  "default_timeout": 120,
  "vms": {
    "my-test-vm": {
      "vmx": "D:\\VMs\\TestVM\\TestVM.vmx",
      "guest_user": "Administrator",
      "guest_password": "${VM_PASSWORD}",
      "snapshot": "clean",
      "description": "Test environment"
    }
  }
}

Passwords use ${ENV_VAR} syntax — set them as environment variables in your MCP config:

{
  "mcpServers": {
    "vmware": {
      "command": "uvx",
      "args": [
        "--from", "git+https://github.com/slupro/vmware-mcp.git",
        "vmware-mcp", "--config", "/path/to/config.json"
      ],
      "env": { "VM_PASSWORD": "your-password" }
    }
  }
}

Tools

Category Tools
Lifecycle vm_list, vm_start, vm_stop, vm_restart
Snapshots vm_snapshot_list, vm_snapshot_create, vm_snapshot_restore, vm_snapshot_delete
Files vm_copy_to_guest, vm_copy_from_guest, vm_file_exists, vm_directory_exists
Execution vm_run_command, vm_run_script, vm_list_processes, vm_kill_process, vm_capture_screen
Info vm_get_ip, vm_read_variable

WSL Note

When running from WSL, the server automatically converts Windows executable paths (e.g. C:\Program Files\...\vmrun.exe) to WSL mount paths (/mnt/c/...). VM and guest paths stay in Windows format as vmrun.exe expects them.

License

MIT

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages