# VMware VKS

VMware VKS connects AI assistants to vSphere Kubernetes Service for TKC cluster lifecycle and namespace control. Built for infrastructure teams on vSphere 8.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 repo stars
- Author: vmware-skills
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/vmware-skills/VMware-VKS
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/vmware-vks

## What it 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.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `VMWARE_VKS_CONFIG` — keys and tokens: ask the human for the values, never commit them or put them in shared files.
- Works with: Kubernetes

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env VMWARE_VKS_CONFIG=<VMWARE_VKS_CONFIG> --transport stdio vmware-vks -- uvx vmware-vks
```
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>

### Codex

**Platform CLI**
```bash
codex mcp add vmware-vks --env VMWARE_VKS_CONFIG=<VMWARE_VKS_CONFIG> -- uvx vmware-vks
```
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>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e VMWARE_VKS_CONFIG=<VMWARE_VKS_CONFIG> vmware-vks uvx vmware-vks
```
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>

## When to use it
- 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
- 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

## Similar
- [VMware vSphere MCP](https://affpapa.org/en/nevibecode/mcp/vmware-vsphere-mcp.md) — MCP server · ★ 87 repo stars
- [vmware-aiops](https://affpapa.org/en/nevibecode/skills/vmware-aiops.md) — skill · ★ 87 repo stars
- [VMware Monitor](https://affpapa.org/en/nevibecode/mcp/vmware-monitor.md) — MCP server · ★ 20 repo stars
- [vmware-vcenter-attack](https://affpapa.org/en/nevibecode/skills/vmware-vcenter-attack.md) — skill · ★ 16193 repo stars
- [K8sCortex - Kubernetes MCP Server](https://affpapa.org/en/nevibecode/mcp/k8scortex-kubernetes-mcp-server.md) — MCP server · 2994 installs
- [gke-basics](https://affpapa.org/en/nevibecode/skills/gke-basics.md) — skill · 13953 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
