razvanmacovei/k8s-multicluster-mcp

An MCP (Model Context Protocol) server for managing multiple Kubernetes clusters simultaneously. Provides 60+ tools covering cluster operations, resource management, monitoring, RBAC, storage, networking, and more -- all accessible through AI assistants like Claude Desktop.
## Quick Start
### Installing via Smithery
bash
npx -y @smithery/cli install @razvanmacovei/k8s-multicluster-mcp --client claude
### Manual Installation
bash
git clone https://github.com/razvanmacovei/k8s-multicluster-mcp.git
cd k8s-multicluster-mcp
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python3 app.py
### Docker
bash
docker build -t k8s-mcp .
docker run -v ~/.kube:/root/.kube k8s-mcp
## Configuration
### Claude Desktop / MCP Client
Add to your MCP client configuration:
json
"mcpServers": {
"kubernetes": {
"command": "python3",
"args": ["/path/to/k8s-multicluster-mcp/app.py"],
"env": {
"KUBECONFIG_DIR": "/path/to/your/kubeconfigs"
### Environment Variables
| Variable | Default | Description |
| KUBECONFIG_DIR | ~/.kube | Directory containing kubeconfig files. Each file can contain one or more contexts. |
Place your kubeconfig files in the configured directory. The server discovers all contexts across all files automatically.
### Prerequisites
Python 3.11 or higher
One or more kubeconfig files with valid cluster credentials
metrics-server installed in clusters for k8s_top_ and k8s_cluster_info tools
## Multi-Cluster Management
This server is purpose-built for managing multiple Kubernetes clusters:
Automatic Discovery: Scans all kubeconfig files in KUBECONFIG_DIR and aggregates contexts
Partial Name Matching: Use prod instead of arn:aws:eks:us-east-1:123456:cluster/prod-cluster
Cross-Cluster Operations: Compare resources, health, and configurations across clusters
Context Caching: Efficient 30-second TTL cache avoids re-reading kubeconfig files on every call
Centralized Management: Manage dev, staging, and production from a single interface
## Tools Reference (60+ tools)
### Cluster & Context Management (6 tools)
| Tool | Description |
| k8s_get_contexts | List all available contexts across all kubeconfig files |
| k8s_get_namespaces | List all namespaces in a cluster |
| k8s_create_ns | Create a new namespace with optional labels/annotations |
| k8s_delete_ns | Delete a namespace (protects system namespaces) |
| k8s_get_nodes | List all nodes with status, roles, capacity, and version |
| k8s_cluster_info | Comprehensive cluster health summary (nodes, pods, deployments, warnings) |
### Resource Discovery & Inspection (7 tools)
| Tool | Description |
| k8s_get_resources | List resources of any kind (pods, deployments, services, ingress, etc.) |
| k8s_get_resource | Get the complete definition of a single resource |
| k8s_get_pod_logs | Get pod logs with duration filtering and container selection |
| k8s_get_events | List cluster events in a namespace, sorted by most recent |
| k8s_describe | Detailed resource description similar to kubectl describe |
| k8s_apis | List all available API groups and resources in the cluster |
| k8s_crds | List all Custom Resource Definitions with versions and scope |
### Metrics & Monitoring (3 tools)