Log inSubmit server
Kubernetes MCP Server logo

Kubernetes MCP Server

by manusa

Native MCP access to Kubernetes and OpenShift for resource management, pod operations, Helm, Tekton, and cluster diagnostics.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Kubernetes MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "manusa-kubernetes-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "kubernetes-mcp-server@latest"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

manusa/Kubernetes MCP Server connects AI clients directly to Kubernetes and OpenShift APIs rather than invoking kubectl or Helm. It supports generic resource CRUD, pod inspection and execution, Helm releases, Tekton workflows, cluster events, node metrics, and selected Kiali and kcp operations. The Go-based server can use kubeconfig contexts or in-cluster configuration and is suitable for diagnosing, changing, and deploying workloads from an MCP-compatible client.

Use cases

  • Inspect cluster events and pod logs during incident diagnosis
  • Apply or remove Kubernetes and OpenShift resources
  • Execute commands in pods and launch test containers
  • Install and manage Helm releases through an AI client
  • Review node, pod, and service-mesh health

Key features

  • Kubernetes and OpenShift API access
  • Generic resource CRUD and Server-Side Apply
  • Pod logs, exec, deletion, launch, and metrics
  • Helm release management
  • Tekton workflow operations
  • Kiali service-mesh diagnostics

Tools78

What Kubernetes MCP Server lets your agent do. Expand a tool for its parameters.

Self-reported~3.2k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

54/54 checks healthy over the last 90d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · kubernetes-mcp-server@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2.2kStargazers on the source repository.
npm downloads182kPackage downloads in the last 30 days.
Last commitTodayMost recent push to the default branch.
Tools exposed78Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Kubernetes MCP Server works

What manusa/Kubernetes MCP Server does

manusa/Kubernetes MCP Server exposes Kubernetes and OpenShift administration through MCP tools. It can inspect configuration, list contexts and targets, enumerate namespaces, projects, pods, nodes, events, and arbitrary API resources, then retrieve, create, update, scale, or delete those resources. Pod-focused tools cover logs, command execution, deletion, resource usage, and launching a container image.

The server also includes Helm release installation, listing, and removal; kcp workspace discovery; and Kiali operations for service-mesh status and traffic topology. The feature set includes Tekton operations for starting and managing Pipelines, PipelineRuns, Tasks, and TaskRuns. Optional OpenTelemetry tracing and metrics are available, including a statistics endpoint.

How it works

The implementation is written in Go and communicates directly with the Kubernetes API server. It is not dependent on installed kubectl or Helm command-line binaries. Kubernetes access can come from kubeconfig configuration or an in-cluster setup, and the server can work with multiple clusters defined by kubeconfig contexts.

Generic resource tools accept Kubernetes API details such as apiVersion, kind, namespace, and resource name. Resource creation and updates use Server-Side Apply. Listing tools support pagination through limits and continuation values where applicable, which helps with large clusters. Node statistics are obtained through the kubelet Summary API, while node and pod usage tools use Kubernetes Metrics Server data.

Setup and configuration

A Kubernetes cluster is required. The project is distributed as native binaries for Linux, macOS, and Windows, and is also available through npm, PyPI, and a container image. Native binaries avoid requiring Node.js or Python on the host.

For Claude Desktop, Cursor, VS Code, and Claude Code, the documented npm setup runs kubernetes-mcp-server@latest through npx. The server also supports command-line arguments, TOML configuration files, and environment-based configuration. It can automatically detect Kubernetes configuration changes and refresh its active configuration.

Tools and capabilities

  • Inspect kubeconfig content, contexts, and available targets.
  • List Kubernetes namespaces, OpenShift projects, events, pods, nodes, and arbitrary resources.
  • Read, create, update, scale, and delete Kubernetes or OpenShift resources.
  • Fetch pod and node logs, execute commands in containers, and start pods from images.
  • Query node and pod CPU and memory usage through Metrics Server, plus node Summary API statistics.
  • Install, list, and uninstall Helm releases.
  • Discover kcp workspaces and retrieve workspace details.
  • Inspect Istio mesh health and service-to-service traffic through Kiali tools.
  • Run selected Tekton Pipeline, PipelineRun, Task, and TaskRun operations.

Limitations and notes

Operations follow the permissions available to the configured Kubernetes identity. Resource updates use the complete desired manifest: fields previously managed by this tool that are omitted from a new manifest are removed, so an existing object should be fetched and modified before reapplying it. Metrics-related results depend on the relevant Kubernetes metrics services, and node statistics require access to the kubelet Summary API. Large lists and Helm release queries may need pagination.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Kubernetes MCP Server

manusa/Kubernetes MCP Server is an MCP server that connects AI clients to Kubernetes and OpenShift clusters through their APIs. Its main tools manage generic resources, inspect pods and nodes, read logs, execute pod commands, operate Helm releases, query events and metrics, and support selected Tekton, kcp, and Kiali workflows.

Install it with the documented native binary, npm, PyPI, or container distribution. For npm-based clients, configure the server to run `npx -y kubernetes-mcp-server@latest`; the cluster must be reachable through kubeconfig or in-cluster configuration.

Yes, Cursor is supported through an MCP configuration that runs `npx -y kubernetes-mcp-server@latest`. The server then uses the Kubernetes configuration available to that process.

Yes, it supports OpenShift as well as Kubernetes. It can perform generic resource operations, list OpenShift projects, and use the same cluster access configuration for OpenShift API resources.

Yes, the `pods_exec` tool runs a supplied command in a named pod in the current or specified namespace. Access is controlled by the Kubernetes permissions of the configured identity.

Related MCP servers

All in Cloud Platforms All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewKubernetes MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/manusa-kubernetes-mcp-server?style=directory)](https://allmcps.com/mcp/manusa-kubernetes-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/manusa-kubernetes-mcp-server"><img src="https://allmcps.com/api/badge/manusa-kubernetes-mcp-server?style=directory" alt="Kubernetes MCP Server on AllMCPs" /></a>