VMware VKS — Claude Code MCP server: what it does, how to install
VMware VKS connects AI assistants to vSphere Kubernetes Service for TKC cluster lifecycle and namespace control. Built for infrastructure teams on vSphere 8.
MIT ★ 6 updated 2026-10-24
claude mcp add --env VMWARE_VKS_CONFIG=<VMWARE_VKS_CONFIG> --transport stdio vmware-vks -- uvx vmware-vksWhat VMware VKS does
This integration exposes 24 MCP tools to manage Tanzu Kubernetes Grid environments. An assistant can inspect Supervisor nodes, provision vSphere Namespaces, adjust TKC worker pools, and issue kubeconfig bearer tokens without leaving the chat interface.
Under the hood, the server combines a vmware-vks command-line binary with settings stored in ~/.vmware-vks/config.yaml. vCenter credentials sit in a dedicated .env file with restrictive permissions. Offline deployment is supported: you can bundle Python wheels on an internet-facing host before transferring them to an isolated network.
Without vSphere 8.0 and active Workload Management on at least one compute cluster, the API calls fail immediately. You also need an Enterprise Plus or VMware Cloud Foundation license. Running vmware-vks check verifies every prerequisite before production use.
What it helps with
- Provision Tanzu Kubernetes clusters across dedicated vSphere namespaces
- Scale worker node counts up or down on demand
- Allocate compute quotas and storage policies to new namespaces
- Issue scoped kubeconfig credentials into local configuration files
Example prompts for the agent
- Run vmware-vks check to verify vCenter readiness and list supervisor clusters
- Create a new namespace dev with CPU and memory limits
- Scale the dev-cluster worker nodes to 6 and check the provisioning phase
How to install VMware VKS
Platform CLI
claude mcp add --env VMWARE_VKS_CONFIG=<VMWARE_VKS_CONFIG> --transport stdio vmware-vks -- uvx vmware-vksReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from vmware-vks <command>
Platform CLI
codex mcp add vmware-vks --env VMWARE_VKS_CONFIG=<VMWARE_VKS_CONFIG> -- uvx vmware-vksReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from vmware-vks <command>
Config file
{
"mcpServers": {
"vmware-vks": {
"command": "uvx",
"args": [
"vmware-vks"
],
"env": {
"VMWARE_VKS_CONFIG": "<VMWARE_VKS_CONFIG>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from vmware-vks <command>
Config file
{
"servers": {
"vmware-vks": {
"type": "stdio",
"command": "uvx",
"args": [
"vmware-vks"
],
"env": {
"VMWARE_VKS_CONFIG": "<VMWARE_VKS_CONFIG>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from vmware-vks <command>
Platform CLI
gemini mcp add -e VMWARE_VKS_CONFIG=<VMWARE_VKS_CONFIG> vmware-vks uvx vmware-vksReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from vmware-vks <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about VMware VKS
How to install VMware VKS in Claude Code?
Run claude mcp add vmware-vks -- uvx vmware-vks. If passing a custom config path, use claude mcp add --env VMWARE_VKS_CONFIG=<VMWARE_VKS_CONFIG> --transport stdio vmware-vks -- uvx vmware-vks.
What does VMware VKS do?
It provides 24 tools for interacting with vSphere Kubernetes Service. AI agents can manage Tanzu cluster lifecycles, configure namespaces, and generate access tokens.
What prerequisites are required?
You need Python 3.10+, vSphere 8.0 or newer, and an active Workload Management configuration on your cluster. An Enterprise Plus or VMware Cloud Foundation license is mandatory.