← Explore all mcp servers

CLUSTER OPERATIONS / containers project

Kubernetes MCP Server

Exposes Kubernetes and OpenShift resource inspection and management using kubeconfig or in-cluster credentials.

“A powerful and flexible Kubernetes Model Context Protocol (MCP) server implementation with support for Kubernetes and OpenShift.”

01 / THE REASONING

Why this made the selection.

  • Supports generic Kubernetes resources, making its role broader than a fixed set of pod commands.
  • Documents toolsets, read-only configuration and a restricted service-account setup.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • README.md at aecddcb7299972afa003b3fbd577f3008b96c8a1 (features, getting started, configuration, toolsets and tool list)
  • docs/configuration.md at the same commit
  • pkg/http/http.go at the same commit
  • cmd/kubernetes-mcp-server/main.go and go.mod at the same commit
  • LICENSE at the same commit

Our findings

  • The Go entrypoint and go.mod (module github.com/containers/kubernetes-mcp-server) establish the implementation language; npx and uvx are launchers for the same executable.
  • HTTP authentication has dedicated OAuth/OIDC guidance (require_oauth, token exchange); local kubeconfig access remains a separate credential boundary.
  • pkg/http/http.go serves Streamable HTTP at /mcp; legacy SSE was not established and is not listed.
  • The default toolsets are config and core. At aecddcb7 the README lists 19 core tools, including pods_delete, pods_exec, pods_run, resources_create_or_update, resources_delete and resources_scale, and 3 config tools: configuration_contexts_list, targets_list and configuration_view.
  • docs/configuration.md says configuration_view is disabled by default in HTTP mode because it exposes kubeconfig contents.
  • configExample is the README's Claude Desktop block at aecddcb7.
  • Correction: the install command recorded on 2026-09-21 (npx kubernetes-mcp-server@latest --config ./mcp-config.toml) does not appear in the README at 6fd66fb4 or at aecddcb7. It is replaced by the README's own TOML launch line.

Not established by this review

  • Server startup, authentication and tool execution were not tested.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Connect a server deliberately.

Upstream setup instructions ↗

DOCUMENTED COMMAND

kubernetes-mcp-server --config /etc/kubernetes-mcp-server/config.toml

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

  1. Get the kubernetes-mcp-server executable. The README names three ways to run it: npx, uvx, or the latest release binary.
  2. Write the TOML file the command names. The README's example sets read_only = true and a toolsets list; read_only and toolsets are TOML settings, not launch flags. Select a kubeconfig or service account restricted to the intended cluster resources.
  3. For HTTP mode, set port in the TOML and explicitly set bind_address = "127.0.0.1" for local access, or configure the documented OAuth/TLS controls before sharing the listener.
  4. The command was copied from the README and not run.

Before you start

  • Access to a Kubernetes cluster (the README's stated requirement), through kubeconfig or in-cluster configuration.
  • npm for npx, uv for uvx, or the downloaded release binary; the README says the native binary needs neither Node nor Python.
  • A TOML configuration file at the command's path.

Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": [
        "-y",
        "kubernetes-mcp-server@latest"
      ]
    }
  }
}

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. Official documentation ↗Checked

    https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/README.md

    Supports: summary, whySelected, bestFor, limitations, install, access, compatibility, transports, upstreamDescription, configExample

  2. https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/LICENSE

    Supports: license

  3. Implementation: go.mod ↗Checked

    https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/go.mod

    Supports: language, review

  4. https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/cmd/kubernetes-mcp-server/main.go

    Supports: language, review

  5. https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/pkg/http/http.go

    Supports: review, transports

  6. https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/docs/configuration.md

    Supports: review, limitations, transports, install, access

Evidence & Ask