mcp-server-kubernetes
This MCP server connects to a Kubernetes cluster and manages it, loading kubeconfig from multiple sources in priority order. The README lists a unified kubectl API (get, describe, create, apply, delete, logs, context, scale, patch, rollout and a generic command), port forwarding, Helm install, upgrade and uninstall with custom values and repositories, template-based Helm tools to bypass authentication issues, pod cleanup for states such as Evicted and CrashLoopBackOff, and node cordon, drain and uncordon. A `k8s-diagnose` prompt walks through systematic pod troubleshooting, and there is a non-destructive mode for read and create/update-only use.
Prerequisites are `kubectl` on your PATH, a valid kubeconfig, access to a cluster (minikube, GKE, Rancher Desktop and so on) and optionally Helm v3. Setup is one line per client, for example `claude mcp add kubernetes -- npx mcp-server-kubernetes` for Claude Code or `codex mcp add kubernetes -- npx mcp-server-kubernetes` for Codex, with instructions for Claude Desktop (including an mcpb connector), VS Code and Cursor. An observability section covers tracking what the server does. It is MIT licensed.
Features
Why choose it
Trade-offs
Maintenance check
- Last commit
- 2026-10-26
- Commits, last 90 days
- 48
- Releases, last 90 days
- 10
- Latest release
- v4.2.1 (2026-10-26)
- Open issues
- 12
- Recent issues with at least one comment
- 5/10
Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.
Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.
Most discussed open issues
- #254 spawnSync kubectl ENOENT error6 comments · 2026-01-06
- #194 Have a way to limit subcommands of a tool5 comments · 2025-08-04
- #191 multiple kubectl files passed through kubeconfig5 comments · 2025-07-23
- #376 ALLOW_ONLY_NON_DESTRUCTIVE_TOOLS still enables 7 tools that declare destructiveHint: true (apply/create/scale/patch/rollout, helm install/up3 comments · 2026-09-20
- #302 Question — `user_config` declaration in `manifest.json`2 comments · 2026-04-27
Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.
Compatibility
Quick start
Use cases
Alternatives
Comments
No comments yet. Be the first!