kubectl-mcp-server

# Kubectl MCP Server A Model Context Protocol (MCP) server for Kubernetes that enables AI assistants like Claude, Cursor, and others to interact with Kubernetes clusters through natural language. [](https://opensource.org/licenses/MIT) [](https://www.python.org/) [](https://kubernetes.io/) [](https://github.com/modelcontextprotocol/modelcontextprotocol) [](https://pypi.org/project/kubectl-mcp-tool/) ## 🎥 Live Demo - Watch `kubectl-mcp-tool` in Action with Claude!  ## 🎥 Live Demo - Watch `kubectl-mcp-tool` in Action with Cursor!  ## 🎥 Live Demo - Watch `kubectl-mcp-tool` in Action with Windsurf!  ## Features ### Core Kubernetes Operations - [x] Connect to a Kubernetes cluster - [x] List and manage pods, services, deployments, and nodes - [x] Create, delete, and describe pods and other resources - [x] Get pod logs and Kubernetes events - [x] Support for Helm v3 operations (installation, upgrades, uninstallation) - [x] kubectl explain and api-resources support - [x] Choose namespace for next commands (memory persistence) - [x] Port forward to pods - [x] Scale deployments and statefulsets - [x] Execute commands in containers - [x] Manage ConfigMaps and Secrets - [x] Rollback deployments to previous versions - [x] Ingress and NetworkPolicy management - [x] Context switching between clusters ### Natural Language Processing - [x] Process natural language queries for kubectl operations - [x] Context-aware commands with memory of previous operations - [x] Human-friendly explanations of Kubernetes concepts - [x] Intelligent command construction from intent - [x] Fallback to kubectl when specialized tools aren't available - [x] Mock data support for offline/testing scenarios - [x] Namespace-aware query handling ### Monitoring - [x] Cluster health monitoring - [x] Resource utilization tracking - [x] Pod status and health checks - [x] Event monitoring and alerting - [x] Node capacity and allocation analysis - [x] Historical performance tracking - [x] Resource usage statistics via kubectl top - [x] Container readiness and liveness tracking ### Security - [x] RBAC validation and verification - [x] Security context auditing - [x] Secure connections to Kubernetes API - [x] Credentials management - [x] Network policy assessment - [x] Container security scanning - [x] Security best practices enforcement - [x] Role and ClusterRole management - [x] ServiceAccount creation and binding - [x] PodSecurityPolicy analysis - [x] RBAC permissions auditing - [x] Security context validation ### Diagnostics - [x] Cluster diagnostics and troubleshooting - [x] Configuration validation - [x] Error analysis and recovery suggestions - [x] Connection status monitoring - [x] Log analysis and pattern detection - [x] Resource constraint identification - [x] Pod health check diagnostics - [x] Common error pattern identification - [x] Resource validation for misconfigurations - [x] Detailed liveness and readiness probe validation ### Advanced Features - [x] Multiple transport protocols support (stdio, SSE) - [x] Integration with multiple AI assistants - [x] Extensible tool framework - [x] Custom resource definition support - [x] Cross-namespace operations - [x] Batch operations on multiple resources - [x] Intelligent resource relationship mapping - [x] Error explanation with recovery suggestions - [x] Volume management and identification ## Architecture ### Model Context Protocol (MCP) Integration The Kubectl MCP Tool implements the [Model Context Protocol (MCP)](https://github.com/modelcontextprotocol/spec), enabling AI assistants to interact with Kubernetes clusters through a standardized interface. The architecture consists of: 1. **MCP Server**: A compliant server that handles requests from MCP clients (AI assistants) 2. **Tools Registry**: Registers Kubernetes operations as MCP tools with schemas 3. **Transport Layer**: Supports stdio, SSE, and HTTP transport methods 4. **Core Operations**: Translates tool calls to Kubernetes API operations 5. **Response Formatter**: Converts Kubernetes responses to MCP-compliant responses ### Request Flow  ### Dual Mode Operation The tool operates in two modes: 1. **CLI Mode**: Direct command-line interface for executing Kubernetes operations 2. **Server Mode**: Running as an MCP server to handle requests from AI assistants ## Installation For detailed installation instructions, please see the [Installation Guide](./docs/INSTALLATION.md). You can install kubectl-mcp-t