================== /// MCP /// /// WEI /// ================== [server:online] [protocol:ready]
weibaohui/kom
by weibaohui
SDK-level toolkit and MCP server for operating Kubernetes (CRUD, logs, SQL-like querying, CRD handling, multi-cluster, 58 built-in tools, stdio & SSE modes).
122
25
Open SourceInstallation
1. Prerequisites:
• Go ≥1.20 installed and in your PATH
• Access to a running Kubernetes cluster (or local kind/minikube)
• A valid kubeconfig file ( default: $HOME/.kube/config ) with permissions to CRUD the desired resources
2. Fetch and build the CLI/server binary:
# Install the kom binary (CLI + MCP server) to your GOPATH/bin
go install github.com/weibaohui/kom/cmd/kom@latest
# Or clone & build manually
git clone https://github.com/weibaohui/kom.git
cd kom
go build -o kom ./cmd/kom
3. (Optional) Run in Docker:
docker build -t kom:latest .
docker run -v $HOME/.kube/config:/root/.kube/config:ro \
-p 8080:8080 kom:latest serve
4. Start the MCP server side of kom:
kom serve \
--kubeconfig $HOME/.kube/config \
--bind 0.0.0.0:8080 # HTTP endpoint that other MCP clients call
5. Test a simple query from another shell:
# List pods in default namespace via SQL-like syntax
kom sql "SELECT * FROM pod WHERE namespace = 'default'" --server http://localhost:8080
6. Upgrade:
go install -u github.com/weibaohui/kom/cmd/kom@latest
Documentation
License: MIT License
Updated 7/30/2025