mcp-k8s

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.