Skip to main content

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

Project description

VMware Workstation Pro MCP Server

VMware Workstation Pro Logo

PyPI version Python versions GitHub Issues PyPI - Downloads License

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.

Windows PowerShell Start REST API

VM Network Adapters Management

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

Star History

Star History Chart

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vmware_workstation_pro_mcp_server-0.1.10.tar.gz (5.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file vmware_workstation_pro_mcp_server-0.1.10.tar.gz.

File metadata

File hashes

Hashes for vmware_workstation_pro_mcp_server-0.1.10.tar.gz
Algorithm Hash digest
SHA256 f36829b321bebc2579e91bde1f42746cec1d86f6f58f8280d6e8334352bd6568
MD5 1cebb617a512eda922cfd6ab89c8d9e0
BLAKE2b-256 9c304021dc9a7e0f30e6dd4f524c03336ef0054b2889ceb85adebe7a5a8cd2f1

See more details on using hashes here.

Provenance

The following attestation bundles were made for vmware_workstation_pro_mcp_server-0.1.10.tar.gz:

Publisher: workflow.yml on gandli/vmware-workstation-pro-mcp-server

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file vmware_workstation_pro_mcp_server-0.1.10-py3-none-any.whl.

File metadata

File hashes

Hashes for vmware_workstation_pro_mcp_server-0.1.10-py3-none-any.whl
Algorithm Hash digest
SHA256 8e942635b920ed4081d65755284b8187818bfe968333566565680f0b42e2bfd6
MD5 89e2ee2257cb6d2f91383675c8ac73ea
BLAKE2b-256 fbcc0b1e5832618efb4013f3b5c4ca7d8399993f11be978d85e126699002a20e

See more details on using hashes here.

Provenance

The following attestation bundles were made for vmware_workstation_pro_mcp_server-0.1.10-py3-none-any.whl:

Publisher: workflow.yml on gandli/vmware-workstation-pro-mcp-server

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page