mcp-k8s

Name: mcp-k8s
Author: beastpu

@beastpu

Repository

About mcp-k8s

mcp tools for k8s resources management using cursor agent

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.