Kubernetes MCP Server

Example Use Cases

• 1

  Inventory cluster resources (namespaces, pods, nodes, deployments, services) for reporting or decision-making.

• 2

  Diagnose runtime issues by retrieving pod status, events, logs pointers, high-restart or CrashLoopBackOff pods and resource YAML.

• 3

  Compare resource utilization and node capacity or identify orphaned resources for cleanup recommendations.

Description

This project implements a Model Context Protocol (MCP) server that provides read-only access to Kubernetes cluster state, resources, and events. It exposes APIs to list namespaces, pods, nodes, deployments, services, events, and to fetch resource YAML for debugging and diagnostics. The server can connect via local kubeconfig or in-cluster configuration and is intended to help agents and tooling quickly inspect cluster health and troubleshoot issues. It is open-source (MIT) and designed for integration with agents such as Claude via MCP.