mcp-k8s-go

README

MCP K8S Go

This project is intended as a both MCP server connecting to Kubernetes and a library to build more servers for any custom resources in Kubernetes.

Currently available:

• resource: K8S contexts as read from kubeconfig configurations
• tool: list-k8s-contexts
• tool: list-k8s-pods in a given context and namespace
• tool: list-k8s-events in a given context and namespace
• tool: get-k8s-pod-logs in a given context and namespace

Example usage with Inspector

To use this MCP server with Inspector you can run it from root folder of this project:

tools/inspector/run.sh

Example usage with Claude Desktop

To use this MCP server with Claude Desktop you would firstly need to install it by running:

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.json file:

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

Now you should be able to run Claude Desktop and:

• see K8S contexts available to attach to conversation as a resource
• ask Claude to list contexts
• ask Claude to list pods in a given context and namespace
• ask Claude to list events in a given context and namespace
• ask Claude to read logs of a given pod in a given context and namespace

Contributing

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

Demo usage with Claude Desktop

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: