basebandit/kai

A Model Context Protocol (MCP) server for managing Kubernetes clusters from MCP-compatible clients like Claude Desktop, Cursor, and Continue.
## Overview
Kai exposes Kubernetes operations as MCP tools, letting an LLM client manage your cluster through natural language — workloads, networking, config, storage, RBAC, custom resources, and raw manifests.
## Features
### Core Workloads
[x] Pods - Create, list, get, delete, and stream logs
[x] Deployments - Create, list, describe, and update
[x] Jobs - Batch workload management (create, get, list, delete)
[x] CronJobs - Scheduled batch workloads (create, get, list, delete)
### Networking
[x] Services - Create, get, list, and delete
[x] Ingress - HTTP/HTTPS routing, TLS configuration (create, get, list, update, delete)
### Configuration
[x] ConfigMaps - Configuration management (create, get, list, update, delete)
[x] Secrets - Secret management (create, get, list, update, delete)
[x] Namespaces - Namespace management (create, get, list, delete)
### Cluster Operations
[x] Context Management - Switch contexts, list contexts, rename, delete
[x] Nodes - Node monitoring, cordoning, and draining (list, get, cordon, uncordon, drain)
[x] Cluster Health - Cluster status and resource metrics (cluster health, node/pod metrics)
### Storage
[x] Persistent Volumes - PV management (list, get, delete) and PVC management (create, list, get, delete)
[x] Storage Classes - Storage class operations (list, get)
### Security
[x] RBAC - Roles, RoleBindings, ClusterRoles, ClusterRoleBindings, and ServiceAccounts (list, get)
### Utilities
[x] Port Forwarding - Forward ports to pods and services (start, stop, list sessions)
### Advanced
[x] Apply/Delete Manifests - Apply or delete raw YAML/JSON, multi-document and any kind including CRDs (applyyaml, deleteyaml)
[x] Custom Resources - CRD and custom resource operations (list/get CRDs, list/get/delete custom resources)
[x] Events - Event listing and filtering (by namespace, type, involved object)
[x] API Discovery - API resource exploration (listapiresources)
## Requirements
The server connects to your current kubectl context by default. Ensure you have access to a Kubernetes cluster configured for kubectl (e.g., minikube, Rancher Desktop, kind, EKS, GKE, AKS).
## Installation
sh
go install github.com/basebandit/kai/cmd/kai@latest
### Container image
A multi-arch image (linux/amd64, linux/arm64) is published on Docker Hub:
sh
docker pull cyclon/kai:v1.0.0
docker run --rm cyclon/kai:v1.0.0 -version
## CLI Options
kai [options]
Options:
-kubeconfig string Path to kubeconfig file (default "~/.kube/config")
-context string Name for the loaded context (default "local")
-in-cluster Use in-cluster config (when running inside a pod)
-transport string stdio (default), streamable-http, or sse-legacy
-sse-addr string HTTP listen address for streamable-http/sse-legacy (default ":8080")
-tls-cert string Path to TLS certificate (enables HTTPS)
-tls-key string Path to TLS private key (enables HTTPS)
-request-timeout duration Timeout for Kubernetes API requests (default 30s)
-metrics Expose Prometheus metrics at /metrics (default true)
-log-format string json (default) or text