Golang-based MCP server connecting to Kubernetes

MCP K8S Go

Features ⚙ Browse With Inspector ⚙ Use With Claude ⚙ Contributing

Features

• 🗂️ resource: K8S contexts from kubeconfig file
• 🤖 tool: list-k8s-contexts
• 🤖 tool: list-k8s-namespaces
• 🤖 tool: list-k8s-nodes
• 🤖 tool: list-k8s-resources
  • includes custom mappings for resources like pods, services, deployments
• 🤖 tool: get-k8s-resource
• 🤖 tool: list-k8s-events
• 🤖 tool: get-k8s-pod-logs
• 🤖 tool: k8s-pod-exec would run command in specified pod
• 💬 prompt: list-k8s-namespaces
• 💬 prompt: list-k8s-pods

Browse With Inspector

To use latest published version with Inspector you can run this:

npx @modelcontextprotocol/inspector npx @strowk/mcp-k8s

, or to use version built from sources, then in root folder of this project:

tools/inspector/run.sh

Use With Claude

Demo Usage

Following chat with Claude Desktop demonstrates how it looks when selected particular context as a resource and then asked to check pod logs for errors in kube-system namespace:

To use this MCP server with Claude Desktop you would firstly need to install it.

You have several options for installation:

	Smithery	mcp-get	Pre-built NPM	Pre-built in Github	From sources
Claude Setup	Auto	Auto	Manual	Manual	Manual
Prerequisite	Node.js	Node.js	Node.js	None	Golang

Using Smithery

To install MCP K8S Go for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @strowk/mcp-k8s --client claude

Using mcp-get

To install MCP K8S Go for Claude Desktop automatically via mcp-get:

npx @michaellatman/mcp-get@latest install @strowk/mcp-k8s

Manually with prebuilt binaries

Prebuilt from npm

Use this if you have npm installed and want to use pre-built binaries:

npm install -g @strowk/mcp-k8s

Then check version by running mcp-k8s --version and if this printed installed version, you can proceed to add configuration to claude_desktop_config.json file:

{
  "mcpServers": {
    "mcp_k8s": {
      "command": "mcp-k8s",
      "args": []
    }
  }
}

From GitHub releases

Head to GitHub releases and download the latest release for your platform.

Unpack the archive, which would contain binary named mcp-k8s-go, put that binary somewhere in your PATH and then add the following configuration to the claude_desktop_config.json file:

{
  "mcpServers": {
    "mcp_k8s": {
      "command": "mcp-k8s-go",
      "args": []
    }
  }
}

Building from source

You would need Golang installed to build this project:

go get github.com/strowk/mcp-k8s-go
go install github.com/strowk/mcp-k8s-go

, and then add the following configuration to the claude_desktop_config.json file:

{
  "mcpServers": {
    "mcp_k8s_go": {
      "command": "mcp-k8s-go",
      "args": []
    }
  }
}

Environment Variables and Command-line Options

The following environment variables are used by the MCP server:

• KUBECONFIG: Path to your Kubernetes configuration file (optional, defaults to ~/.kube/config)

The following command-line options are supported:

• --allowed-contexts=<ctx1,ctx2,...>: Comma-separated list of allowed Kubernetes contexts that users can access. If not specified, all contexts are allowed.
• --help: Display help information
• --version: Display version information

Contributing

Check out CONTRIBUTION.md for more information on how to contribute to this project.