How to add mcp-k8s-eye to Claude Desktop

Manage Kubernetes clusters and diagnose workload health via MCP. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 28★ · stdio · no auth

Claude Desktop config for mcp-k8s-eye

git clone https://github.com/wenhuwang/mcp-k8s-eye.git && cd mcp-k8s-eye && go build -o mcp-k8s-eye

{
  "mcpServers": {
    "mcp-k8s-eye": {
      "command": "YOUR mcp-k8s-eye PATH",
      "args": [],
      "env": {
        "HOME": "USER HOME DIR"
      }
    }
  }
}

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the mcp-k8s-eye config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm mcp-k8s-eye's tools appear under the 🔌 tools menu.

Before you start

Go 1.23 or higher (to build the binary)
kubectl configured with access to a Kubernetes cluster
A valid kubeconfig file (referenced via the HOME environment variable)

What mcp-k8s-eye can do in Claude Desktop

resource_get

Get detailed resource information about a specific resource in a namespace.

resource_list

List detailed resource information about all resources in a namespace.

resource_create_or_update

Create or update a resource in a namespace.

resource_delete

Delete a resource in a namespace.

resource_describe

Describe a resource's detailed information in a namespace.

deployment_scale

Scale a deployment in a namespace.

pod_exec

Execute a command in a pod in a namespace.

pod_logs

Get logs from a pod in a namespace.

Security

Operates against your configured Kubernetes cluster using your kubeconfig (set env.HOME to the directory containing the kubeconfig). It can create, update, and delete resources, scale deployments, and execute commands inside pods, so it has the same privileges as your kubeconfig context — restrict access accordingly.

mcp-k8s-eye + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the mcp-k8s-eye config there under the "mcpServers" key and restart the client.

Is mcp-k8s-eye safe to use with Claude Desktop?

How do I install it?

Clone the repo and build the binary with Go 1.23+: 'git clone https://github.com/wenhuwang/mcp-k8s-eye.git && cd mcp-k8s-eye && go build -o mcp-k8s-eye'.

How does it connect to my cluster?

It uses your kubeconfig. In Stdio mode you set env.HOME to the directory containing the kubeconfig file.

Which transports are supported?

Both Stdio and SSE. For SSE, start the server and point the client at its /sse URL (e.g. http://localhost:8080/sse).

View repo Full mcp-k8s-eye page