Kubernetes MCP Server Documentation
July 21, 2026 ยท View on GitHub
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.
Getting Started Guides
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 |
Recommended Workflow
- 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
- Configuration Reference - Complete reference for TOML configuration files, including all options, drop-in configuration, and dynamic reload
Toolset Guides
- Kiali - Tools for Kiali ServiceMesh with Istio
- NetObserv - Network observability flows, metrics, and alerts (Helm on OpenShift)
- KubeVirt - KubeVirt virtual machine management tools
- Tekton - Tekton PipelineRun, TaskRun, and troubleshooting tools
Feature Specifications
Living documentation for implemented and planned features:
| Spec | Description | Status |
|---|---|---|
| Validation | Pre-execution validation layer (resource existence, schema, RBAC) | Implemented |
| Structured Tool Output | Conventions for tools that emit structuredContent | Implemented |
Advanced Topics
- 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
Reference
- Main README - Project overview and general information