Manages multiple Kubernetes clusters at once using several kubeconfig files, covering resources, monitoring and RBAC.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add k8s-multicluster --env KUBECONFIG_DIR='<KUBECONFIG_DIR>' -- uv --directory /servers/k8s-multicluster-mcp run app.py~/.codex/config.toml
[mcp_servers.k8s-multicluster]
command = "uv"
args = ["--directory", "/servers/k8s-multicluster-mcp", "run", "app.py"]
env = { KUBECONFIG_DIR = "<KUBECONFIG_DIR>" }
# codex mcp add k8s-multicluster --env KUBECONFIG_DIR='<KUBECONFIG_DIR>' -- uv --directory /servers/k8s-multicluster-mcp run app.py~/.cursor/mcp.json
{
"mcpServers": {
"k8s-multicluster": {
"command": "uv",
"args": [
"--directory",
"/servers/k8s-multicluster-mcp",
"run",
"app.py"
],
"env": {
"KUBECONFIG_DIR": "<KUBECONFIG_DIR>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"k8s-multicluster": {
"type": "stdio",
"command": "uv",
"args": [
"--directory",
"/servers/k8s-multicluster-mcp",
"run",
"app.py"
],
"env": {
"KUBECONFIG_DIR": "<KUBECONFIG_DIR>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"k8s-multicluster": {
"command": "uv",
"args": [
"--directory",
"/servers/k8s-multicluster-mcp",
"run",
"app.py"
],
"env": {
"KUBECONFIG_DIR": "<KUBECONFIG_DIR>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"k8s-multicluster": {
"command": "uv",
"args": [
"--directory",
"/servers/k8s-multicluster-mcp",
"run",
"app.py"
],
"env": {
"KUBECONFIG_DIR": "<KUBECONFIG_DIR>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"k8s-multicluster": {
"command": "uv",
"args": [
"--directory",
"/servers/k8s-multicluster-mcp",
"run",
"app.py"
],
"env": {
"KUBECONFIG_DIR": "<KUBECONFIG_DIR>"
}
}
}
}Environment variables
KUBECONFIG_DIR
Replace the placeholders with your own credentials and keep them out of version control.