vmware-workstation-pro-mcp-server 0.1.8

A MCP server for managing VMware Workstation Pro VMs via REST API

VMware Workstation Pro MCP Server

Overview

A Model Context Protocol (MCP) server for managing VMware Workstation Pro virtual machines through its REST API. This server enables seamless integration with AI assistants and other tools that support the MCP standard.

Features

• Host Network Management: Configure and manage virtual networks
• Virtual Machine Management: Create, modify, and delete VMs
• Network Adapter Configuration: Customize VM network settings
• VM Power Control: Start, stop, pause, and reset virtual machines
• Shared Folder Management: Configure shared folders between host and VMs

System Requirements

• VMware Workstation Pro 14+ with REST API enabled
• Python 3.10+
• uv (recommended) or pip

Installation

# Install with uv (recommended)
uv pip install vmware-workstation-pro-mcp-server

# Or install with pip
pip install vmware-workstation-pro-mcp-server

Setup Guide

1. Configure the VMware Workstation Pro REST API

First, set up credentials for the VMware Workstation REST API:

.\vmrest.exe -C
VMware Workstation REST API
Copyright (C) 2018-2025 Broadcom.
All Rights Reserved

vmrest 1.3.1 build-24832109
Username: user
New password:
Retype new password:
Processing...
Credential updated successfully

2. Start the VMware Workstation Pro REST API

Launch the REST API service:

cd "C:\Program Files (x86)\VMware\VMware Workstation"
.\vmrest.exe
VMware Workstation REST API
Copyright (C) 2018-2025 Broadcom.
All Rights Reserved
vmrest 1.3.1 build-24832109
-
Using the VMware Workstation UI while API calls are in progress is not recommended and may yield unexpected results
-
Serving HTTP on 127.0.0.1:8697
-
Press Ctrl+C to stop.

The API service will be available at http://localhost:8697 by default.

3. Configure the MCP Server

Add the following configuration to your MCP client setup:

{
  "mcpServers": {
    "vmware-workstation-pro": {
      "command": "uvx",
      "args": ["vmware-workstation-pro-mcp-server"],
      "env": {
        "VMREST_USER": "your-username",
        "VMREST_PASS": "your-password"
      }
    }
  }
}

Available MCP Tools

list_vms

• Description: List all available virtual machines.
• Parameters: None
• Returns: Array of VM objects with their IDs and basic information

get_vm_info

• Description: Retrieve detailed information about a specific VM.
• Parameters:
  • vm_id (string) — The ID of the virtual machine
• Returns: Detailed VM configuration and status information

power_vm

• Description: Perform a power operation on a VM.
• Parameters:
  • vm_id (string) — The ID of the virtual machine
  • action (string) — One of: "on", "off", "suspend", "pause", "unpause", "reset"
• Returns: Operation status

get_vm_power_state

• Description: Get the current power state of a VM.
• Parameters:
  • vm_id (string) — The ID of the virtual machine
• Returns: Current power state of the VM

References

• VMware Fusion MCP Server
• FastMCP Documentation
• Model Context Protocol
• uvx
• Fetch Server Example
• VMware Workstation REST API

Star History