GitHub

Flux159/mcp-server-kubernetes for Claude Code | Awesome…

Usage with mcp-chat

mcp-chat is a CLI chat client for MCP servers. You can use it to interact with the Kubernetes server.

npx mcp-chat --server "npx mcp-server-kubernetes"

Alternatively, pass it your existing Claude Desktop configuration file from above (Linux should pass the correct path to config):

Mac:

npx mcp-chat --config "~/Library/Application Support/Claude/claude_desktop_config.json"

Windows:

npx mcp-chat --config "%APPDATA%\Claude\claude_desktop_config.json"

Connect to a Kubernetes cluster
Unified kubectl API for managing resources
- Get or list resources with kubectl_get
- Describe resources with kubectl_describe
- List resources with kubectl_get
- Create resources with kubectl_create
- Apply YAML manifests with kubectl_apply
- Delete resources with kubectl_delete
- Get logs with kubectl_logs
- Manage kubectl contexts with kubectl_context
- Explain Kubernetes resources with explain_resource
- List API resources with list_api_resources
- Scale resources with kubectl_scale
- Update field(s) of a resource with kubectl_patch
- Manage deployment rollouts with kubectl_rollout
- Execute any kubectl command with kubectl_generic
- Verify connection with ping
Advanced operations
- Scale deployments with kubectl_scale (replaces legacy scale_deployment)
- Port forward to pods and services with port_forward
- Run Helm operations
  - Install, upgrade, and uninstall charts
  - Support for custom values, repositories, and versions
  - Template-based installation (helm_template_apply) to bypass authentication issues
  - Template-based uninstallation (helm_template_uninstall) to bypass authentication issues
- Pod cleanup operations
  - Clean up problematic pods (cleanup_pods) in states: Evicted, ContainerStatusUnknown, Completed, Error, ImagePullBackOff, CrashLoopBackOff
- Node management operations
  - Cordoning, draining, and uncordoning nodes (node_management) for maintenance and scaling operations
Troubleshooting Prompt (k8s-diagnose)
- Guides through a systematic Kubernetes troubleshooting flow for pods based on a keyword and optional namespace.
Non-destructive mode for read and create/update-only access to clusters
Secrets masking for security (masks sensitive data in kubectl get secrets commands, does not affect logs)
OpenTelemetry Observability (opt-in)
- Distributed tracing for all tool calls
- Export to Jaeger, Tempo, Grafana, or any OTLP backend
- Configurable sampling strategies
- Rich span attributes (tool name, duration, K8s context, errors)
- See docs/OBSERVABILITY.md for details

Gemini CLI allows you to install mcp servers as extensions. From a shell, install the extension by pointing to this repo:

gemini extensions install https://github.com/Flux159/mcp-server-kubernetes

mcp-server-kubernetes

What the docs cover

Keep exploring from this skill

Related Skills

ECC

n8n

gemini-cli