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.
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.
- Get the kubernetes-mcp-server executable. The README names three ways to run it: npx, uvx, or the latest release binary.
- 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.
- 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.
- 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.
- 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
- Applicable source licence ↗Checked
https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/LICENSE
Supports: license
- Implementation: go.mod ↗Checked
https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/go.mod
Supports: language, review
https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/cmd/kubernetes-mcp-server/main.go
Supports: language, review
https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/pkg/http/http.go
Supports: review, transports
https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/docs/configuration.md
Supports: review, limitations, transports, install, access