This project provides a Golang-based Model Context Protocol (MCP) server that bridges large language models (LLMs) with Kubernetes clusters. It enables LLM clients like Claude to interact with Kubernetes resources, allowing users to list contexts, namespaces, nodes, pods, retrieve resource details, get pod logs, and execute commands within pods.

How It Works

The server leverages the official Kubernetes Go client library to interact with the cluster. It exposes a standardized MCP interface, allowing LLM clients to query and manipulate Kubernetes resources through natural language prompts. The architecture supports various integration methods, including direct binary execution, Docker, and automatic setup via tools like Smithery or mcp-get.

Quick Start & Requirements

• Install/Run: Multiple options available:
  • NPM: npm install -g @strowk/mcp-k8s then mcp-k8s
  • Npx: npx @strowk/mcp-k8s
  • Docker: docker run -i -v ~/.kube/config:/home/nonroot/.kube/config --rm mcpk8s/server:latest
  • Build from source: Requires Go.
• Prerequisites: Kubernetes configuration (~/.kube/config by default). Node.js for NPM/Npx installations. Docker for Docker image.
• Links: Claude Desktop Demo

Highlighted Details

• Supports listing and retrieving any Kubernetes resource, including custom ones.
• Enables running commands directly within Kubernetes pods.
• Offers multi-architecture Docker images (amd64, arm64).
• Allows restricting access to specific Kubernetes contexts via --allowed-contexts.

Maintenance & Community

No specific community channels or contributor information is detailed in the README.

Licensing & Compatibility

The README does not explicitly state a license. Compatibility for commercial use or closed-source linking is not specified.

Limitations & Caveats

The project appears to be in beta (0.3.1-beta.2 mentioned). Detailed documentation on error handling, security considerations, and advanced configuration is not readily available in the README.