MCP K8S Go - Model Context Protocol Server

About this MCP

MCP K8S Go is a Model Context Protocol server that provides AI assistants with the ability to interact with Kubernetes clusters. It allows AI models to browse and manage Kubernetes resources through a standardized interface, enabling them to list contexts, namespaces, pods, and other resources, as well as retrieve detailed information and logs from your Kubernetes environment. This tool bridges the gap between AI assistants and Kubernetes infrastructure management, making it possible to use natural language to explore and troubleshoot your clusters. With support for multiple contexts and namespaces, it provides a comprehensive interface for Kubernetes operations through AI-assisted workflows.

Documentation

Overview

MCP K8S Go is a Golang implementation of a Model Context Protocol server that connects to Kubernetes clusters. It allows AI assistants like Claude to interact with your Kubernetes infrastructure, providing capabilities to list and inspect various Kubernetes resources.

Installation Options

You have several ways to install and use MCP K8S Go:

1. Using Smithery (Recommended for Claude)

The easiest way to install and configure MCP K8S Go for Claude Desktop:

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

2. Using mcp-get

Another automated installation option:

npx -y @modelcontextprotocol/get install @strowk/mcp-k8s --client claude

3. Using Pre-built NPM Package

npm install -g @strowk/mcp-k8s

After installation, you'll need to manually configure Claude Desktop to use this MCP server.

4. Using Pre-built Binaries from GitHub Releases

Download the appropriate binary for your platform from the GitHub Releases page.

5. Building from Source

If you have Go installed, you can build from source:

git clone https://github.com/strowk/mcp-k8s-go.git
cd mcp-k8s-go
go build

Usage with Inspector

To test the MCP server with the Inspector tool:

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

Or if you've built from source:

tools/inspector/run.sh

Available Tools

MCP K8S Go provides the following tools for interacting with Kubernetes:

list-k8s-contexts

Lists all available Kubernetes contexts from your kubeconfig.

list-k8s-namespaces

Lists all namespaces in a specified Kubernetes context.

list-k8s-nodes

Lists all nodes in a specified Kubernetes context.

list-k8s-resources

Lists resources of a specified kind in a given context and namespace. Includes special mappings for common resources like pods, services, and deployments.

get-k8s-resource

Retrieves detailed information about a specific resource by name, kind, context, and namespace.

list-k8s-events

Lists events in a specified context and namespace.

get-k8s-pod-logs

Retrieves logs from a specified pod in a given context and namespace.

Prompts

The MCP server also provides predefined prompts:

list-k8s-namespaces: Lists namespaces in a given context
list-k8s-pods: Lists pods in the current context and specified namespace

Configuration

By default, MCP K8S Go uses your standard kubeconfig file (typically located at ~/.kube/config). The server respects the current context and configuration from this file.

You can specify a different kubeconfig file using the --kubeconfig flag when starting the server.

Security Considerations

MCP K8S Go provides AI assistants with access to your Kubernetes clusters. Be mindful of the permissions granted to the kubeconfig contexts you're using with this tool, especially in production environments.

Troubleshooting

If you encounter issues:

Verify your kubeconfig file is correctly configured
Ensure you have appropriate permissions for the operations you're attempting
Check that the Kubernetes API server is accessible from your environment

For more detailed information, visit the GitHub repository.