mcp-k8s

Overview

mcp-k8s is a lightweight Kubernetes management tool providing sse and stdio mode for Kubernetes cluster management. It simplifies Kubernetes resources operation in cursor IDE.

Key Features

• Kubernetes cluster connection and management
• Kubernetes node management (view, cordon, uncordon, restart)
• Pod management (view, delete, log retrieval, command execution)
• OpenKruise resource management (view, describe, and scale CloneSets and AdvancedStatefulSets)
• ConfigMap management
• Multi-cluster context switching

Requirements

• Go 1.18+
• Kubernetes cluster
• Valid kubeconfig file

Build Instructions

In the project root directory, run:

go build -o k8s

Usage

The application supports two running modes:

• stdio mode: For command-line interaction
• SSE mode: Starts an HTTP server for API access

Start in SSE mode:

./k8s -mode=sse -address=:8686

Start in stdio mode:

./k8s -mode=stdio

Cursor mcp.json

{
  "mcpServers": {
    "k8s": {
     "url": "http://127.0.0.1:8686/sse"
    }
  }
}

Project Structure

• biz/: Business logic code
  • clientset/: Kubernetes client related code
  • pod/: Pod operations
  • node/: Node management
  • context/: Cluster context management
  • kruise/: OpenKruise resource management
  • configmap/: ConfigMap management
• main.go: Application entry point