{"id":"e783214a-3b58-4f55-9e63-dc9809b5ef76","slug":"sandraschi-kubernetes-mcp","kind":"mcp","name":"kubernetes-mcp","summary":"FastMCP 3.4.4+ server and React companion webapp for Kubernetes cluster orchestration and Minikube automation","owner":"sandraschi","repoUrl":"https://github.com/sandraschi/kubernetes-mcp","license":"MIT","licenseTier":"permissive","trust":"community","stars":1,"match":null,"fewStars":true,"format":"mcp","createdAt":"2026-07-20T14:45:47.000Z","addedAt":"2026-10-21T04:51:00.831Z","logoUrl":"https://avatars.githubusercontent.com/u/34750307?u=166281f79cd1114c24ba073dc02fd578660cbff0&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["cloud-infra"],"tags":["k8s","kubernetes","minikube","python","react"],"runtime":"python","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-27T00:35:44.116Z","sample":false,"url":"https://conduits.dev/tools/sandraschi-kubernetes-mcp","language":"JavaScript","transports":["stdio"],"install":{"pypi":"kubernetes-mcp"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# kubernetes-mcp\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)\n[![FastMCP 3.4.4+](https://img.shields.io/badge/FastMCP-3.4.4+-orange.svg)](https://github.com/modelcontextprotocol/sdk)\n\nFastMCP 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.\n\n## Preview\n| Dashboard | Workloads |\n|-----------|---------|\n| ![Dashboard](docs/screenshots/dashboard.png) | ![Workloads](docs/screenshots/workloads.png) |\n*Caption: Zinc/Blue dashboard visualizes Kubernetes namespaces, cluster node health, pods status, and streams container logs.*\n\n## Features\n- **Cluster Diagnostics**: View Node ready states, CPU/Memory capacities, and active context details.\n- **Log Streaming & Troubleshooting**: Retrieve raw container logs and inspect pod event logs to debug startup failures.\n- **Deployment Control**: Scale deployments, trigger rollout restarts, and apply resource YAML configurations dynamically.\n- **Minikube local controls**: Start and stop Minikube local VMs, and monitor Kubelet runtime services.\n- **Companion Dashboard**: Responsive frontend UI showing pods diagnostics, networking service routes, and local AI copilot autodiscovery (Ollama/LM Studio).\n\n## Quick Install\n1. Open your Claude Desktop config file: `%APPDATA%\\Claude\\claude_desktop_config.json`\n2. Add the server block:\n```json\n{\n  \"mcpServers\": {\n    \"kubernetes-mcp\": {\n      \"command\": \"uv\",\n      \"args\": [\"--directory\", \"d:/Dev/repos/kubernetes-mcp\", \"run\", \"python\", \"-m\", \"kubernetes_mcp\"]\n    }\n  }\n}\n```\n3. Restart Claude Desktop.\n\n## Documentation\n\n| Documentation | Purpose |\n|---------------|---------|\n| [Installation Guide](INSTALL.md) | All local installation options, prerequisites, and startup scripts. |\n| [Configuration](docs/CONFIGURATION.md) | Custom env variables (`WEB_PORT`, `WEB_HOST`, `MCP_TRANSPORT`). |\n| [Tool Reference](docs/TOOLS.md) | Parameters and functions list of all registered MCP tools. |\n| [Development Setup](docs/DEVELOPMENT.md) | Local source development, formatting, linting, and testing with `just`. |\n| [Troubleshooting FAQ](docs/TROUBLESHOOTING.md) | Solutions for typical cluster context connectivity errors. |\n| [Kubernetes & Minikube Explainer](docs/EXPLAINER.md) | K8s vs Vanilla Docker comparison, history, bibliography, and community links. |\n\n## Requirements\n- OS: Windows 10/11 (PowerShell support), macOS, or Linux.\n- Active kubeconfig credentials (`~/.kube/config`).\n- Python `>=3.12` and Bun runtime.\n\n## License\nMIT License\n"}