k8s-mcp-server

Overview

The k8s-mcp-server is a full-featured implementation of the Model Context Protocol for Kubernetes cluster management. It provides extensive functionality including resource discovery, listing, details retrieval, pod logs access, node metrics, event listing, and resource creation/deletion operations. The server supports multiple deployment modes including stdio, SSE, and streamable-http, making it versatile for both CLI and web application integrations. It also offers robust security features with multiple authentication methods and a read-only mode for safe exploration of clusters.

Try asking AI

After installing, here are 7 things you can ask your AI assistant:

• getAPIResources

  Get all available API resources in your Kubernetes cluster

  Try:List all available API resourcesTry:Show me what Kubernetes resources I can work with
• listResources

  List resources of any type with optional namespace and label filtering

  Try:List all pods in the default namespaceTry:Show all deployments with label app=web
• getResource

  Get detailed information about specific Kubernetes resources

  Try:Get details for pod nginx-123Try:Show the configmap for my-app
• describeResource

  Get comprehensive descriptions of Kubernetes resources, similar to kubectl describe

  Try:Describe the node kube-node-1Try:Describe the service my-service
• getPodsLogs

  Retrieve logs from specific pods

  Try:Get logs from pod nginx-456Try:Show logs from container web in my-app pod
• getNodeMetrics

  Get resource usage metrics for specific nodes

  Try:Show CPU and memory usage for node kube-node-1Try:Get metrics for all nodes
• getPodMetrics

  Get CPU and Memory metrics for specific pods

  Try:Show metrics for pod nginx-456Try:Get resource usage for all pods in production
• getEvents

  List events within a namespace or for a specific resource

  Try:Show events in the default namespaceTry:Get events for deployment my-app
• createResource

  Create new Kubernetes resources or update existing ones from a YAML or JSON manifest

  Try:Create a new namespace for my projectTry:Update the configmap for my-app with this file
• deleteResource

  Delete a resource in the Kubernetes cluster based on the provided namespace and kind

  Try:Delete pod nginx-456Try:Remove the service my-service
• helmList

  List all Helm releases in a namespace

  Try:Show all Helm releases in the default namespaceTry:List releases in production namespace
• helmInstall

  Install a new Helm chart in the cluster

  Try:Install Prometheus using the Helm chartTry:Deploy my application with Helm

Comparable tools

Installation

git clone https://github.com/reza-gholizade/k8s-mcp-server.git
cd k8s-mcp-server
go mod download
go build -o k8s-mcp-server main.go

docker pull ginnux/k8s-mcp-server:latest
docker run -p 8080:8080 -v ~/.kube/config:/home/appuser/.kube/config:ro ginnux/k8s-mcp-server:latest

{
  "mcpServers": {
    "kubernetes": {
      "command": "k8s-mcp-server",
      "args": ["--mode", "stdio"],
      "env": {
        "KUBECONFIG": "/path/to/your/kubeconfig"
      }
    }
  }
}

FAQ

What authentication methods does this server support?

The server supports multiple authentication methods in priority order: kubeconfig content from environment variable, API server URL and token, in-cluster service account authentication, and kubeconfig file path.

Can I run this in read-only mode?

Yes, use the --read-only flag to disable all write operations, making it safer to explore and monitor your Kubernetes cluster without making changes.

What are the different server modes?

The server supports three modes: stdio for CLI integrations, SSE for web applications with Server-Sent Events, and streamable-http for web applications with MCP HTTP transport.

Compare k8s-mcp-server with