Kubernetes MCP Server

Implements a standardized Model Context Protocol (MCP) server that translates JSON-RPC requests from MCP clients (Claude Desktop, etc.) into native Kubernetes API calls via the Go client library. The server handles protocol initialization handshakes where client and server exchange capability information, then routes incoming tool/resource/prompt requests to appropriate Kubernetes operations. Uses a stateless request-response pattern with no persistent connection state, allowing clients to discover available operations dynamically.

Exposes all configured Kubernetes contexts from the user's kubeconfig file as discoverable resources through the MCP protocol. The server reads the kubeconfig at startup and maintains a list of available contexts, allowing clients to query which clusters are accessible and switch between them dynamically. Each context maps to a separate Kubernetes client instance that targets that cluster's API server.

Provides a tool to retrieve Kubernetes events from the cluster, which record significant occurrences like pod scheduling, image pulls, restarts, and errors. Queries the Kubernetes API for Event resources, optionally filtered by namespace, involved object, or time range. Events provide a timeline of cluster activity and are essential for troubleshooting. Returns structured event data with timestamps, reasons, messages, and involved resources.

Provides a tool that retrieves logs from Kubernetes pods by querying the Kubernetes API's log endpoint. Supports filtering by pod name, namespace, container name, and optional line count limits. The implementation uses the Go Kubernetes client's PodLogOptions to construct log requests, then streams or buffers the response depending on the client's needs. Handles multi-container pods by allowing container selection.

Implements pod exec functionality by establishing a WebSocket connection to the Kubernetes API's exec endpoint, allowing arbitrary commands to be executed inside running containers. Uses the Go client's Executor interface to handle stdin/stdout/stderr streams. Supports specifying target pod, namespace, container, and command with arguments. Handles connection setup, stream multiplexing, and error propagation back to the MCP client.

Provides tools to list Kubernetes resources (pods, deployments, services, nodes, events) with optional filtering by namespace, label selectors, and field selectors. Uses the Go Kubernetes client's List operations with ListOptions to construct filtered queries. Returns structured JSON representations of resources with key metadata (name, namespace, status, age, etc.). Supports querying across all namespaces or specific namespaces.

Provides a tool to retrieve detailed information about a specific Kubernetes resource (pod, deployment, service, etc.) by name and namespace. Uses the Go Kubernetes client's Get operation to fetch the full resource spec and status. Returns comprehensive metadata including labels, annotations, resource requests/limits, conditions, events, and other diagnostic information. Useful for deep-dive troubleshooting and understanding resource configuration.

Provides a tool to apply Kubernetes YAML configurations to the cluster, supporting both resource creation and updates. Accepts YAML strings as input and uses the Go Kubernetes client's dynamic client to parse and apply resources. Supports multiple resources in a single YAML file (separated by '---'). Uses server-side apply semantics where available, allowing declarative configuration management. Handles resource versioning and API group resolution automatically.

Exposes pre-built prompt templates through the MCP Prompts system that guide users through common Kubernetes operations like listing pods or namespaces. These prompts are discoverable by MCP clients and can be invoked to generate structured queries. The prompts provide context-aware suggestions and parameter hints, making it easier for non-expert users to construct valid Kubernetes queries. Implemented as static prompt definitions that map to underlying tools.

Provides tools to list all namespaces in the current Kubernetes context and retrieve the default namespace for the active context. Queries the Kubernetes API for all Namespace resources and extracts the default namespace from the kubeconfig context configuration. Allows clients to discover available namespaces and understand the current operational scope without manual configuration.

Provides a tool to list all nodes in the Kubernetes cluster with their resource capacity, allocatable resources, and current utilization status. Queries the Kubernetes API for Node resources and extracts capacity, allocatable, and status information. Allows operators to understand cluster resource availability and identify resource constraints or node issues. Returns structured data including CPU, memory, storage, and pod count information.