概览
What is mcp-k8s?
mcp-k8s is a lightweight Kubernetes management tool that provides SSE and stdio modes for Kubernetes cluster management. It is designed to simplify Kubernetes resource operations within the Cursor IDE.
How to use mcp-k8s?
Build from source using go build -o k8s, then run in SSE mode with ./k8s -mode=sse -address=:8686 or in stdio mode with ./k8s -mode=stdio. For Cursor IDE, configure mcp.json with the SSE endpoint URL.
Key features of mcp-k8s
- Kubernetes cluster connection and management
- Node management: view, cordon, uncordon, restart
- Pod management: view, delete, log retrieval, command execution
- OpenKruise resource management: view, describe, scale CloneSets and AdvancedStatefulSets
- ConfigMap management
- Multi-cluster context switching
Use cases of mcp-k8s
- Operate Kubernetes resources directly from Cursor IDE
- Quickly view and manage pods, nodes, and ConfigMaps
- Scale OpenKruise resources like CloneSets
- Switch between multiple Kubernetes cluster contexts
FAQ from mcp-k8s
What are the runtime requirements for mcp-k8s?
Go 1.18+ is required to build the binary, and you need a Kubernetes cluster with a valid kubeconfig file.
How does mcp-k8s connect to a Kubernetes cluster?
It uses the standard kubeconfig file for authentication and cluster connection, supporting multi-context switching.
What transports does mcp-k8s support?
It supports two modes: stdio for command-line interaction and SSE (Server-Sent Events) to start an HTTP server for API access, typically on port 8686.
Does mcp-k8s support OpenKruise resources?
Yes, it supports viewing, describing, and scaling CloneSets and AdvancedStatefulSets from OpenKruise.
Can I use mcp-k8s without Cursor IDE?
Yes, you can run it in stdio mode for general command-line use, but the README highlights integration with Cursor IDE via SSE mode.
