==================
      
       /// MCP ///
      /// K8M ///
        
    ==================
        
    [server:online]
    [protocol:ready]

k8m

by weibaohui

AI-driven mini Kubernetes dashboard (MCP-enabled). Single-binary server with built-in LLMs, multi-cluster management, Kom-based k8s client, AMIS front-end and 49+ MCP tools.

590
97
Open Source

Installation

1. Prerequisites
• Go 1.22+ (only needed if you want to build from source)
• kubectl configured (~/.kube/config) and at least one reachable Kubernetes cluster
• Docker or containerd (optional, for container deployment)
2. Download a pre-built binary (recommended)
# choose linux/amd64 as example curl -Lo k8m https://github.com/weibaohui/k8m/releases/latest/download/k8m-linux-amd64 chmod +x k8m
3. OR build from source
git clone https://github.com/weibaohui/k8m.git cd k8m go build -o k8m ./cmd/k8m
4. Run the dashboard locally
./k8m --kubeconfig=$HOME/.kube/config --listen=:8080 # open http://localhost:8080 in your browser
5. Container deployment
-p 8080:8080 \
-v $HOME/.kube/config:/root/.kube/config:ro \
-e K8M_ADMIN_PASSWORD="change-me" \
--name k8m weibaohui/k8m:latest
docker pull weibaohui/k8m:latest docker run -d \
6. Helm chart (multi-cluster)
--set adminPassword="change-me" --namespace k8m --create-namespace
helm repo add k8m https://weibaohui.github.io/k8m-charts helm install k8m k8m/k8m-dashboard \
7. Configuration highlights
• K8M_ADMIN_PASSWORD – initial admin password
• K8M_MCP_ENABLE=true – enable MCP model/agent center
• K8M_MCP_OPENAI_KEY=xxx – OpenAI API key for LLM features
• K8M_CLUSTER_MODE=multi – manage multiple clusters
• K8M_STORAGE=./data – path to local DB
8. Upgrade
Download/ pull newer image, replace the running container or run `helm upgrade`.

Documentation

License: MIT License
Updated 7/30/2025

Table of Contents