Kubernetes MCP Server

Name: Kubernetes MCP Server
Author: containers

by containersversion 0.1.0i★ 2,224iRuns on your computer

Registry nameio.github.containers/kubernetes-mcp-server

Overview

Description from the maker (original English)

A Model Context Protocol (MCP) server for Kubernetes and OpenShift

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi3 of 3 passedChecked from public information; code not scanned yet
UsageiGrowing★ 2,224

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio, Streamable HTTP
Category: Developer tools

Install

Pick the AI app you use, then copy the settings.

You need

npmNode.js installed (for the npx command)

Claude DesktopClaude CodeCursorVS Code

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

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

Run this in your terminal

claude mcp add kubernetes -- npx -y kubernetes-mcp-server

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

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

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "kubernetes": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "kubernetes-mcp-server"
      ]
    }
  }
}

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 5, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account containers, which owns the repo
✓ Pass
Still maintained
Code last changed today
✓ Pass
Has a licence
Uses Apache-2.0
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Needs the server’s tool list first; this check starts in the next step

Compared with others in Developer toolsi

More stars than 69% of the other 13 servers in this category
Published to the registry more recently than 62% of the other 13 servers in this category
Basic checks equal to or better than 100% of the other 13 servers in this category

Compared only with servers in this prototype, not the whole registry.

Common questions

Is Kubernetes MCP Server safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed today, and the latest version (0.1.0) reached the registry 7 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js, Python (uv), Docker on your computer.

What can I use instead?

In the same category: GitHub, Desktop Commander, Cloudflare MCP

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

GitHub

by github

GitHub’s official server lets AI read and manage code, issues and pull requests in your account. Use GitHub’s hosted version or run it locally with Docker.

Computer or cloud★ 34,245MITUpdated 2 days ago

Desktop Commander

by wonderwhy-er

MCP server for terminal commands, file operations, and process management

Runs on your computer★ 10,225MITUpdated 14 days ago

Cloudflare MCP

by cloudflare

Cloudflare MCP servers

Runs in the cloud★ 4,446Apache-2.0Updated 14 months ago

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Kubernetes MCP Server

https://github.com/user-attachments/assets/be2b67b3-fc1c-4d11-ae46-93deba8ed98e

✨ Features

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

✅ Configuration:
Automatically detect changes in the Kubernetes configuration and update the MCP server.
View and manage the current Kubernetes .kube/config or in-cluster configuration.
✅ Generic Kubernetes Resources: Perform operations on any Kubernetes or OpenShift resource.
Any CRUD operation (Create or Update, Get, List, Delete).
✅ Pods: Perform Pod-specific operations.
List pods in all namespaces or in a specific namespace.
Get a pod by name from the specified namespace.
Delete a pod by name from the specified namespace.
Show logs for a pod by name from the specified namespace.
Top gets resource usage metrics for all pods or a specific pod in the specified namespace.
Exec into a pod and run a command.
Run a container image in a pod and optionally expose it.
✅ Namespaces: List Kubernetes Namespaces.
✅ Events: View Kubernetes events in all namespaces or in a specific namespace.
✅ Projects: List OpenShift Projects.
☸️ Helm:
Install a Helm chart in the current or provided namespace.
List Helm releases in all namespaces or in a specific namespace.
Uninstall a Helm release in the current or provided namespace.
🔧 Tekton: Tekton-specific operations that complement generic Kubernetes resource management.
Pipeline: Start a Tekton Pipeline by creating a PipelineRun.
PipelineRun: Restart, cancel, troubleshoot, and retrieve PipelineRun logs.
Task: Start a Tekton Task by creating a TaskRun.
TaskRun: Restart a TaskRun with the same spec, and retrieve TaskRun logs via pod resolution.
🔭 Observability: Optional OpenTelemetry distributed tracing and metrics with custom sampling rates. Includes /stats endpoint for real-time statistics. See OTEL.md.

Unlike other Kubernetes MCP server implementations, this IS NOT just a wrapper around kubectl or helm command-line tools. It is a Go-based native implementation that interacts directly with the Kubernetes API server.

There is NO NEED for external dependencies or tools to be installed on the system. If you're using the native binaries you don't need to have Node or Python installed on your system.

✅ Lightweight: The server is distributed as a single native binary for Linux, macOS, and Windows.
✅ High-Performance / Low-Latency: Directly interacts with the Kubernetes API server without the overhead of calling and waiting for external commands.
✅ Multi-Cluster: Can interact with multiple Kubernetes clusters simultaneously (as defined in your kubeconfig files).
✅ Cross-Platform: Available as a native binary for Linux, macOS, and Windows, as well as an npm package, a Python package, and container/Docker image.
✅ Configurable: Supports command-line arguments, TOML configuration files, and environment variables.
✅ Well tested: The server has an extensive test suite to ensure its reliability and correctness across different Kubernetes environments.
📚 Documentation: Comprehensive user documentation including setup guides, configuration reference, and observability.

🚀 Getting Started

Requirements

Access to a Kubernetes cluster.

Claude Code

Follow the dedicated Claude Code getting started guide in our user documentation.

For a secure production setup with dedicated ServiceAccount and read-only access, also review the Kubernetes setup guide.

Claude Desktop

Using npx

If you have npm installed, this is the fastest way to get started with kubernetes-mcp-server on Claude Desktop.

Open your claude_desktop_config.json and add the mcp server to the list of mcpServers:

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

VS Code / VS Code Insiders

Install the Kubernetes MCP server extension in VS Code Insiders by pressing the following link:

Alternatively, you can install the extension manually by running the following command:

# For VS Code

code --add-mcp '{"name":"kubernetes","command":"npx","args":["kubernetes-mcp-server@latest"]}'

For VS Code Insiders

code-insiders --add-mcp '{"name":"kubernetes","command":"npx","args":["kubernetes-mcp-server@latest"]}'

Cursor

Install the Kubernetes MCP server extension in Cursor by pressing the following link:

Alternatively, you can install the extension manually by editing the mcp.json file:

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

Goose CLI

Goose CLI is the easiest (and cheapest) way to get rolling with artificial intelligence (AI) agents.

Using npm

If you have npm installed, this is the fastest way to get started with kubernetes-mcp-server.

Open your goose config.yaml and add the mcp server to the list of mcpServers:

extensions:

kubernetes: command: npx args:

-y
kubernetes-mcp-server@latest

🎥 Demos

Diagnosing and automatically fixing an OpenShift Deployment

Demo showcasing how Kubernetes MCP server is leveraged by Claude Desktop to automatically diagnose and fix a deployment in OpenShift without any user assistance.

https://github.com/user-attachments/assets/a576176d-a142-4c19-b9aa-a83dc4b8d941

_Vibe Coding_ a simple game and deploying it to OpenShift

In this demo, I walk you through the process of _Vibe Coding_ a simple game using VS Code and how to leverage Podman MCP server and Kubernetes MCP server to deploy it to OpenShift.

Supercharge GitHub Copilot with Kubernetes MCP Server in VS Code - One-Click Setup!

In this demo, I'll show you how to set up Kubernetes MCP server in VS code just by clicking a link.

⚙️ Configuration

The Kubernetes MCP server can be configured using command line (CLI) arguments.

You can run the CLI executable either by using npx, uvx, or by downloading the latest release binary.

# Run the Kubernetes MCP server using npx (in case you have npm and node installed)

npx kubernetes-mcp-server@latest --help

# Run the Kubernetes MCP server using uvx (in case you have uv and python installed)

uvx kubernetes-mcp-server@latest --help

# Run the Kubernetes MCP server using the latest release binary

./kubernetes-mcp-server --help

Configuration Options

Option	Description
`--version`	Print version information and quit.
`--config`	Path to the main TOML configuration file, or `-` to read it from stdin (HTTP mode only). See Configuration Reference for all options (port, toolsets, read_only, kubeconfig, …).
`--config-dir`	Directory of lexical `.toml` files. Usable alone or with `--config`. Omitted means no drop-ins. Relative paths are resolved against the working directory.

Note: Runtime settings are TOML (or existing env names), not CLI flags. See Configuration Changes for the flag-to-TOML mapping.

TOML Configuration Files

For complex or persistent configurations, use TOML configuration files instead of CLI arguments:

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

Example configuration:

log_level = 2

read_only = true toolsets = ["core", "config", "helm", "kubevirt"]

Deny access to sensitive resources

[[denied_resources]] group = "" version = "v1" kind = "Secret"

[telemetry] endpoint = "http://localhost:4317"

For comprehensive TOML configuration documentation, including:

All configuration options and their defaults
Drop-in configuration files for modular settings
Dynamic configuration reload via SIGHUP
Denied resources for restricting access to sensitive resource types
Server instructions for MCP Tool Search
Custom MCP prompts
OAuth/OIDC authentication for HTTP mode (Keycloak, Microsoft Entra ID)

See the [Configuration Reference](docs/configuration.md).

📊 MCP Logging

The server supports the MCP logging capability, allowing clients to receive debugging information via structured log messages. Kubernetes API errors are automatically categorized and logged to clients with appropriate severity levels. MCP log notifications apply best-effort redaction for known credential patterns before being sent to clients. This does not sanitize tool results or guarantee removal of a

Only the beginning is shown; read the rest in the repo

Kubernetes MCP Server

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Developer toolsi

Common questions

Alternatives

GitHub

Desktop Commander

Cloudflare MCP

README from the maker

Kubernetes MCP Server

✨ Features

🚀 Getting Started

Requirements

Claude Desktop

Using npx

VS Code / VS Code Insiders

For VS Code Insiders

Cursor

Goose CLI

Using npm

🎥 Demos

Diagnosing and automatically fixing an OpenShift Deployment

_Vibe Coding_ a simple game and deploying it to OpenShift

Supercharge GitHub Copilot with Kubernetes MCP Server in VS Code - One-Click Setup!

⚙️ Configuration

Configuration Options

TOML Configuration Files

Deny access to sensitive resources

📊 MCP Logging