zw008 avatar

VMware VKS

zw008/vmware-vks

Connects Claude to VMware vSphere 8.x Workload Management APIs and Supervisor Kubernetes endpoints to provision and manage Tanzu Kubernetes clusters. Exposes 20 tools split across supervisor status checks, vSphere namespace lifecycle (create, update quotas, delete with guard rails), and TanzuKubernetesCluster operations including creation with dry-run previews, worker scaling, version upgrades, and kubeconfig extraction. Uses pyVmomi for vCenter REST calls and the Kubernetes Python client against the Supervisor API, auto-detecting cluster.x-k8s.io v1 or v1beta1. Best for platform teams managing containerized workloads on vSphere who need namespace provisioning, TKC deployments, and day-2 cluster operations accessible through natural language. Community project by a VMware engineer, not an official Broadcom release.

GitHub stars
5
tools
25
transport
STDIO
last updated
Jul 21, 2026

Tools

25 tools

Public tool metadata for what this MCP can expose to an agent.

check_vks_compatibilityvCenter version check + WCP status

vCenter version check + WCP status

No parameter schema in public metadata yet.

get_supervisor_upgrade_riskvCenter 9.1.0/9.1.1 pre-upgrade advisory scope; VUMDB schema remains unmeasured; links to the official checker

vCenter 9.1.0/9.1.1 pre-upgrade advisory scope; VUMDB schema remains unmeasured; links to the official checker

No parameter schema in public metadata yet.

get_supervisor_statusSupervisor cluster status and K8s API endpoint

Supervisor cluster status and K8s API endpoint

No parameter schema in public metadata yet.

list_supervisor_storage_policiesvCenter storage policies (policy ID, name, description)

vCenter storage policies (policy ID, name, description)

No parameter schema in public metadata yet.

list_namespacesAll vSphere Namespaces with status

All vSphere Namespaces with status

No parameter schema in public metadata yet.

get_namespaceNamespace detail (quotas, storage, roles)

Namespace detail (quotas, storage, roles)

No parameter schema in public metadata yet.

create_namespaceCreate Namespace; previews by default (confirm=True applies)

Create Namespace; previews by default (confirm=True applies)

No parameter schema in public metadata yet.

update_namespaceModify quotas and storage policy

Modify quotas and storage policy

No parameter schema in public metadata yet.

delete_namespaceDelete with TKC guard (rejects if clusters exist)

Delete with TKC guard (rejects if clusters exist)

No parameter schema in public metadata yet.

list_vm_classesAvailable VM classes for TKC sizing

Available VM classes for TKC sizing

No parameter schema in public metadata yet.

list_tkc_clustersTanzuKubernetesCluster list with status

TanzuKubernetesCluster list with status

No parameter schema in public metadata yet.

get_tkc_clusterCluster detail (nodes, health, conditions)

Cluster detail (nodes, health, conditions)

No parameter schema in public metadata yet.

get_tkc_available_versionsSupported K8s versions on Supervisor

Supported K8s versions on Supervisor

No parameter schema in public metadata yet.

create_tkc_clusterCreate TKC; previews the YAML plan by default (confirm=True applies)

Create TKC; previews the YAML plan by default (confirm=True applies)

No parameter schema in public metadata yet.

scale_tkc_clusterScale worker node count

Scale worker node count

No parameter schema in public metadata yet.

upgrade_tkc_clusterUpgrade K8s version

Upgrade K8s version

No parameter schema in public metadata yet.

delete_tkc_clusterDelete with workload guard

Delete with workload guard

No parameter schema in public metadata yet.

issue_supervisor_kubeconfigSupervisor kubeconfig — credential (bearer token); inline or owner-only file

Supervisor kubeconfig — credential (bearer token); inline or owner-only file

No parameter schema in public metadata yet.

issue_tkc_kubeconfigTKC kubeconfig — credential (bearer token); inline or owner-only file

TKC kubeconfig — credential (bearer token); inline or owner-only file

No parameter schema in public metadata yet.

get_harbor_infoEmbedded Harbor registry info (id, cluster, version, URL, health, storage used)

Embedded Harbor registry info (id, cluster, version, URL, health, storage used)

No parameter schema in public metadata yet.

list_namespace_storage_usagePVC list and capacity stats

PVC list and capacity stats

No parameter schema in public metadata yet.

list_vm_service_snapshotsVirtualMachineSnapshot objects in a vSphere Namespace

VirtualMachineSnapshot objects in a vSphere Namespace

No parameter schema in public metadata yet.

list_vm_service_groupsVirtualMachineGroup objects and their boot order in a Namespace

VirtualMachineGroup objects and their boot order in a Namespace

No parameter schema in public metadata yet.

list_vm_service_network_interfacesNetwork interfaces (multi-NIC) of one VM Service VirtualMachine

Network interfaces (multi-NIC) of one VM Service VirtualMachine

No parameter schema in public metadata yet.

get_access_infoWhich account the server uses and whether it holds each tool's vSphere privileges on the root folder. Kubernetes calls are authorized by the namespace's own permissions, which it does not check

Which account the server uses and whether it holds each tool's vSphere privileges on the root folder. Kubernetes calls are authorized by the namespace's own permissions, which it does not check

No parameter schema in public metadata yet.

Sponsors

Readme

VMware-VKS

Work with Supervisor and VKS Kubernetes lifecycle using discovered APIs.

English · 简体中文

Community-maintained · MIT · Not an official VMware/Broadcom product.

24-second illustrative investigation demo

Synthetic-data GIF; video includes redacted historical screenshots. Download the AI-narrated family introduction (~3 min)

Why use it?

  • Inspect namespaces, VM classes and storage policies.
  • Use explicit ClusterClass and server validation where supported.
  • Expose conditions and discovery gaps instead of guessing.

Get started

Install the published CLI and inspect its commands:


View the full README on GitHub

Details

Repository
github.com/zw008/vmware-vks
Package
vmware-vks
Transport
STDIO
Registry
MCP registry, active

More from zw008