VMware VKS MCP server
vSphere with Tanzu (VKS): Namespace and TanzuKubernetesCluster lifecycle. Requires vSphere 8.x+.
5 stars434 downloads/wk
Reviews
Write oneNobody has reviewed VMware VKS yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
VMware VKS tools (20, 5 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
check_vks_compatibility[READ] Check whether this vCenter supports VKS (requires vSphere 8.x+).
create_namespacewrite action[WRITE] Create a vSphere Namespace on a Supervisor Cluster.
create_tkc_clusterwrite action[WRITE] Create a TanzuKubernetesCluster in a vSphere Namespace.
delete_namespacewrite action[WRITE] Delete a vSphere Namespace and everything inside it.
delete_tkc_clusterwrite action[WRITE] Delete a TKC cluster and all of its nodes.
get_harbor_info[READ] Get status of the embedded Harbor container registry on the Supervisor.
get_namespace[READ] Get detailed configuration for a single vSphere Namespace.
get_supervisor_kubeconfig[READ] Get a kubeconfig for the Supervisor K8s API endpoint.
get_supervisor_status[READ] Get the health of one Supervisor Cluster (vSphere with Tanzu control plane).
get_tkc_available_versions[READ] List Kubernetes versions (TanzuKubernetesReleases) available on the Supervisor.
get_tkc_cluster[READ] Get detailed status for a single TKC cluster.
get_tkc_kubeconfig[READ] Get a kubeconfig for one TKC cluster.
list_namespace_storage_usage[READ] List PersistentVolumeClaims and storage usage inside one vSphere Namespace.
list_namespaces[READ] List all vSphere Namespaces on the target vCenter with their status.
list_supervisor_storage_policies[READ] List vCenter storage policies assignable to Supervisor Namespaces.
list_tkc_clusters[READ] List TanzuKubernetesCluster (TKC) clusters, optionally in one namespace.
list_vm_classes[READ] List VM classes available for sizing TKC cluster nodes.
scale_tkc_cluster[WRITE] Scale the worker node count of an existing TanzuKubernetesCluster (TKC).
update_namespacewrite action[WRITE] Update resource quotas or storage policy of an existing vSphere Namespace.
upgrade_tkc_cluster[WRITE] Upgrade a TKC cluster to a new Kubernetes version.
Public scan report
scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it
- Code scan28 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 5 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
What the publisher says
From the VMware VKS repository's README, as published. We do not edit it. Read it on GitHub
<!-- mcp-name: io.github.vmware-skills/vmware-vks -->
VMware VKS
Author: Wei Zhou, VMware by Broadcom — wei-wz.zhou@broadcom.com
This is a community-driven project by a VMware engineer, not an official VMware product.
For official VMware developer tools see developer.broadcom.com.
English | 中文
MCP Skill + CLI for VMware vSphere Kubernetes Service (VKS) management — Supervisor clusters, vSphere Namespaces, and VKS Cluster lifecycle. 23 MCP tools.
Companion Skills
Part of the VMware MCP Skills family. Each skill handles a distinct domain — install only what you need.
Prerequisites
- Python 3.10+ — required for uv tool install
- vSphere 8.0+ — Workload Management (Supervisor) APIs require vSphere 8.x
- Workload Management enabled — WCP must be enabled on at least one compute cluster
- License — vSphere Kubernetes Service (Enterprise Plus or VMware Cloud Foundation)
Run vmware-vks check after setup to verify all requirements are met.
Quick Start
# Install
uv tool install vmware-vks
# Configure
mkdir -p ~/.vmware-vks
cp config.example.yaml ~/.vmware-vks/config.yaml
# Edit config.yaml with your vCenter host and username
# One password env var per target, named after the target in config.yaml:
# target "vcenter01" (the one config.example.yaml ships) -> VMWARE_VKS_VCENTER01_PASSWORD
echo "VMWARE_VKS_VCENTER01_PASSWORD=your_password" > ~/.vmware-vks/.env
chmod 600 ~/.vmware-vks/.env
# Verify
vmware-vks check
# Common operations
vmware-vks supervisor status domain-c1
vmware-vks namespace list
vmware-vks tkc list
vmware-vks tkc create my-cluster -n dev --version v1.28.4+vmware.1 --vm-class best-effort-large
vmware-vks tkc create my-cluster -n dev --applyOffline / Air-Gapped Install (from source)
This project uses the modern PEP 517 build system (hatchling), so there is no setup.py by design — that is expected, not a missing file. If you cloned the source and hit ERROR: File "setup.py" or "setup.cfg" not found ... editable mode currently requires a setuptools-based build, your pip is older than 21.3 and cannot do an editable (-e) install with a non-setuptools backend. Editable mode is a developer convenience, not needed to run the tool — do one of:
# From the source tree — a normal (non-editable) install builds a wheel:
pip install . # NOT pip install -e .
# ...or upgrade pip first, and editable works too:
pip install --upgrade pip && pip install -e .For a truly air-gapped host, build the wheels on a connected machine and copy them over — the target then needs no network:
# On a connected machine, collect this package + its dependencies as wheels:
pip wheel . -w dist # → dist/*.whl (or: uv build, for just this package)Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Install directly
claude mcp add vmware-vks -- uvx vmware-vks
VMware VKS: common questions
- Is VMware VKS MCP server safe?
- Yes, by our scan: it is graded A (94/100). Read the VMware VKS safety report
- How do I install VMware VKS?
- It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
- Does VMware VKS need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is VMware VKS maintained?
- The last commit was 6 days ago (2026-09-20). The latest release is v1.8.8.