mcp server

kubernetes-mcp

FastMCP 3.4.4+ server and React companion webapp for Kubernetes cluster orchestration and Minikube automation

sandraschi/kubernetes-mcpcommunitylistedunreviewed

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

uv (`curl -LsSf https://astral.sh/uv/install.sh | sh`)

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "sandraschi-kubernetes-mcp": {
      "command": "uvx",
      "args": [
        "kubernetes-mcp"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 27, 2026

kubernetes-mcp

FastMCP 3.4.4+ server for Kubernetes cluster orchestration and local Minikube cluster management. Includes an interactive fullstack React web companion application designed to Zinc/Blue SOTA dark-mode aesthetics.

Preview

Dashboard	Workloads

Caption: Zinc/Blue dashboard visualizes Kubernetes namespaces, cluster node health, pods status, and streams container logs.

Features

Cluster Diagnostics: View Node ready states, CPU/Memory capacities, and active context details.
Log Streaming & Troubleshooting: Retrieve raw container logs and inspect pod event logs to debug startup failures.
Deployment Control: Scale deployments, trigger rollout restarts, and apply resource YAML configurations dynamically.
Minikube local controls: Start and stop Minikube local VMs, and monitor Kubelet runtime services.
Companion Dashboard: Responsive frontend UI showing pods diagnostics, networking service routes, and local AI copilot autodiscovery (Ollama/LM Studio).

Quick Install

Open your Claude Desktop config file: %APPDATA%\Claude\claude_desktop_config.json
Add the server block:

{
  "mcpServers": {
    "kubernetes-mcp": {
      "command": "uv",
      "args": ["--directory", "d:/Dev/repos/kubernetes-mcp", "run", "python", "-m", "kubernetes_mcp"]
    }
  }
}

Restart Claude Desktop.

Documentation

Documentation	Purpose
Installation Guide	All local installation options, prerequisites, and startup scripts.
Configuration	Custom env variables (`WEB_PORT`, `WEB_HOST`, `MCP_TRANSPORT`).
Tool Reference	Parameters and functions list of all registered MCP tools.
Development Setup	Local source development, formatting, linting, and testing with `just`.
Troubleshooting FAQ	Solutions for typical cluster context connectivity errors.
Kubernetes & Minikube Explainer	K8s vs Vanilla Docker comparison, history, bibliography, and community links.

Requirements

OS: Windows 10/11 (PowerShell support), macOS, or Linux.
Active kubeconfig credentials (~/.kube/config).
Python >=3.12 and Bun runtime.

License

MIT License