Kubernetes MCP Server

A Model Context Protocol (MCP) server for managing a Kubernetes cluster through llms like Claude.

Overview

This Kubernetes MCP server provides a bridge between large language models (LLMs) and Kubernetes clusters, enabling users to interact with their Kubernetes resources through natural language. The server exposes a comprehensive set of tools for managing clusters, namespaces, pods, deployments, services, and other Kubernetes resources.

Features

Cluster Management

• Connect to a Kubernetes cluster
• List all clusters in kubeconfig
• Switch between clusters
• Get cluster information
• Check cluster health

Namespace Operations

• List all namespaces
• Create a namespace
• Get namespace details
• Delete a namespace
• Update namespace labels/annotations

Pod Operations

• Create pods

  Details

  • Basic pod creation with image and name
  • Pod creation with environment variables
  • Pod creation with volume mounts
  • Pod creation with resource limits/requests
  • Pod creation with node selectors

• List pods

  Details

  • List pods in current namespace
  • List pods across all namespaces
  • List pods with label selectors
  • List pods with field selectors
  • Limit number of pods listed

• Get pod details

  Details

  • Get basic pod information
  • Get pod status
  • Get pod IP and node information

• Delete pods

  Details

  • Delete pod by name
  • Force delete pods

• Get logs from pods

  Details

  • Stream logs from a specific container
  • Get logs with tail lines limit
  • Get logs from previous container instance
  • Get logs since a specific time

Deployment Operations

• Create deployments

  Details

  • Basic deployment with image and name
  • Deployment with replica count
  • Deployment with labels
  • Deployment with environment variables
  • Deployment with container ports
  • Deployment with image pull policy/secrets

• List deployments

  Details

  • List deployments in current namespace
  • List deployments across all namespaces
  • List deployments with label selectors

• Get deployment details

  Details

  • Get basic deployment information
  • Get deployment status
  • Get deployment scaling information

• Update deployments

  Details

  • Scale deployments (change replica count)
  • Update deployment images
  • Update deployment configuration
  • Rollout restart

• Delete deployments

  Details

  • Delete deployment by name
  • Cascade delete (with or without dependent resources)

Service Operations

• Create services

  Details

  • Create ClusterIP service
  • Create NodePort service
  • Create LoadBalancer service
  • Create ExternalName service
  • Create headless service

• List services

  Details

  • List services in current namespace
  • List services across all namespaces
  • List services with label selectors

• Get service details

  Details

  • Get service endpoints
  • Get service ports
  • Get service selectors

• Delete services

  Details

  • Delete service by name

Ingress Operations

• Create ingress

  Details

  • Create basic ingress with host and path
  • Create ingress with TLS
  • Create ingress with annotations

• List ingresses

  Details

  • List ingresses in current namespace
  • List ingresses across all namespaces

• Get ingress details

• Update ingress

• Delete ingress

ConfigMap & Secret Operations

• Create ConfigMaps

  Details

  • Create from literal values
  • Create from files

• List ConfigMaps

• Get ConfigMap details

• Update ConfigMaps

• Delete ConfigMaps

• Create Secrets

  Details

  • Create generic secrets
  • Create TLS secrets
  • Create Docker registry secrets

• List Secrets

• Get Secret details

• Update Secrets

• Delete Secrets

Job & CronJob Operations

• Create Jobs

  Details

  • Create basic job
  • Create job with completion/parallelism

• List Jobs

• Get Job details

• Delete Jobs

• Create CronJobs

  Details

  • Create with schedule
  • Create with suspend option

• List CronJobs

• Get CronJob details

• Delete CronJobs

Node Operations

• List all nodes

• Get node details

  Details

  • Get node capacity/allocatable resources
  • Get node conditions
  • Get node labels/taints

• Cordon/Uncordon nodes

• Drain nodes

Utility Operations

• Port forwarding

  Details

  • Port forward to a pod
  • Port forward to a service

• Get Kubernetes events

  Details

  • Get cluster-wide events
  • Get namespace events
  • Get events for a specific resource

• kubectl explain support

  Details

  • Get resource documentation
  • Get field documentation

• kubectl api-resources support

  Details

  • List all available API resources
  • Get API resource details

Persistent Volume Operations

• Create PersistentVolumes
• List PersistentVolumes
• Get PersistentVolume details
• Delete PersistentVolumes
• Create PersistentVolumeClaims
• List PersistentVolumeClaims
• Get PersistentVolumeClaim details
• Delete PersistentVolumeClaims

RBAC Operations

• Create/List/Get/Delete ServiceAccounts
• Create/List/Get/Delete Roles
• Create/List/Get/Delete RoleBindings
• Create/List/Get/Delete ClusterRoles
• Create/List/Get/Delete ClusterRoleBindings

Custom Resource Operations

• List custom resource definitions
• Get custom resource definition details
• List custom resources of a specific type
• Create/Get/Update/Delete custom resources

Requirements

The server will by default connect to your current context. Make sure you have:

Access to a Kubernetes cluster configured for kubectl (e.g. minikube, Rancher Desktop, EKS, GKE, etc.)

Installation

To install the Kubernetes MCP server, run:

go install github.com/cautiousseash/kai/cmd/kai

Integration with Claude for Desktop

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Add the server to your Claude for Desktop configuration by editing claude_desktop_config.json:

{
  "mcpServers": {
    "kubernetes": {
      "command": "/path/to/kubernetes-mcp-server-binary"
    }
  }
}