How to add mcp-k8s-eye to Windsurf

Manage Kubernetes clusters and diagnose workload health via MCP. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

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

Windsurf 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 Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the mcp-k8s-eye config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5mcp-k8s-eye's tools become available to Cascade.

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 Windsurf

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 + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_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 Windsurf?

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