mcp-server-kubernetes

Executes arbitrary kubectl commands against Kubernetes clusters by translating MCP tool calls into subprocess invocations of the kubectl binary. The server acts as a bridge between Claude/MCP clients and the local kubectl installation, capturing stdout/stderr and returning structured results. Supports full kubectl API surface including resource queries, deployments, logs, and cluster inspection without requiring direct cluster API access.

Provides MCP tools to query Kubernetes resources (pods, deployments, services, configmaps, secrets, etc.) by translating high-level queries into kubectl get/describe commands with JSON output parsing. Enables Claude to inspect cluster state, resource relationships, and metadata without requiring knowledge of kubectl syntax or JSON path expressions. Returns structured resource information suitable for reasoning about cluster configuration and status.

Retrieves pod logs from Kubernetes clusters by executing kubectl logs commands with support for multi-container pods, previous container logs, and log filtering. Captures stdout/stderr from running or terminated containers and returns them as text suitable for Claude analysis. Handles container selection, timestamp filtering, and tail options to retrieve relevant log segments without overwhelming context windows.

Executes kubectl commands to modify Kubernetes resources including scaling deployments, rolling restarts, applying manifests, and deleting resources. Translates high-level operational intents (e.g., 'scale this deployment to 5 replicas') into kubectl apply/patch/delete commands with error handling and confirmation. Supports both imperative commands and declarative manifest application for infrastructure-as-code workflows.

Retrieves Kubernetes events and resource status conditions by executing kubectl get events and describe commands, parsing event timestamps and messages to provide cluster activity visibility. Enables Claude to understand recent cluster changes, failures, and warnings without direct API polling. Supports filtering by namespace, resource type, and time range to focus on relevant events.

Supports switching between multiple Kubernetes clusters defined in kubeconfig by translating MCP tool calls into kubectl context commands. Allows Claude to query or modify resources across different clusters (dev, staging, production) within a single conversation by managing kubectl context state. Validates cluster accessibility and provides context information to prevent accidental operations on wrong clusters.

Provides MCP tools to query and operate on resources within specific Kubernetes namespaces, with automatic namespace parameter handling in kubectl commands. Enables Claude to scope operations to development, staging, or production namespaces without requiring explicit namespace flags in every command. Supports namespace listing, creation, and deletion for environment management workflows.

Checks Kubernetes RBAC permissions by executing kubectl auth can-i commands to verify whether the current user can perform specific actions on resources. Enables Claude to validate permissions before attempting operations and provide informative error messages when access is denied. Supports checking permissions for different verbs (get, create, delete, patch) and resource types.