Welcome to the Kubernetes MCP Server documentation! This directory contains guides to help you set up and use the Kubernetes MCP Server with your Kubernetes cluster and Claude Code CLI.
Choose the guide that matches your needs:
| Guide | Description | Best For |
|---|---|---|
| Getting Started with Kubernetes | Base setup: Create ServiceAccount, token, and kubeconfig | Everyone - start here first |
| Using with Claude Code CLI | Configure MCP server with Claude Code CLI | Claude Code CLI users |
- Complete the base setup: Start with Getting Started with Kubernetes to create a ServiceAccount and kubeconfig file
- Configure Claude Code: Then follow the Claude Code CLI guide
- Configuration Reference - Complete reference for TOML configuration files, including all options, drop-in configuration, and dynamic reload
Living documentation for implemented and planned features:
| Spec | Description | Status |
|---|---|---|
| Validation | Pre-execution validation layer (resource existence, schema, RBAC) | Implemented |
- MCP Logging - Structured logging to MCP clients with automatic K8s error categorization and secret redaction
- OpenTelemetry Observability - Distributed tracing and metrics configuration
- MCP Prompts - Custom workflow templates for AI assistants
- Keycloak OIDC Setup - Developer guide for local Keycloak environment and testing with MCP Inspector
- Main README - Project overview and general information