Kubernetes MCP Server

Model Context Protocol (MCP) server for Kubernetes and OpenShift

Local serverstdioPython

What is the Kubernetes MCP server?

If you already use Kubernetes, the kubernetes mcp server is the piece that lets your assistant work with it directly. Model Context Protocol (MCP) server for Kubernetes and OpenShift.

What the server does

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

Installation

args on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • configuration_contexts_list — List all available context names and associated server urls from the kubeconfig file
  • targets_list — List all available targets
  • configuration_view — Get the current Kubernetes configuration content as a kubeconfig YAML
  • events_list — List Kubernetes events (warnings, errors, state changes) for debugging and troubleshooting in the current cluster from all namespaces
  • namespaces_list — List all the Kubernetes namespaces in the current cluster
  • projects_list — List all the OpenShift projects in the current cluster
  • nodes_log — Get logs from a Kubernetes node (kubelet, kube-proxy, or other system logs). This accesses node logs through the Kubernetes API proxy to the kubelet
  • nodes_stats_summary — Get detailed resource usage statistics from a Kubernetes node via the kubelet's Summary API. Provides comprehensive metrics including CPU, memory
  • nodes_top — List the resource consumption (CPU and memory) as recorded by the Kubernetes Metrics Server for the specified Kubernetes Nodes or all nodes in the
  • Toolset — Description
  • config — View and manage the current local Kubernetes configuration (kubeconfig)
  • core — Most common tools for Kubernetes management (Pods, Generic Resources, Events, etc.)

Credentials and setup notes

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Kubernetes.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Where it fits

Plenty of cloud and infrastructure servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Kubernetes's toolset — configuration_contexts_list, targets_list, configuration_view and 11 more — is a fair guide to whether it matches your workflow. It is maintained by GitHub Actions; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
configuration_contexts_listList all available context names and associated server urls from the kubeconfig file
targets_listList all available targets
configuration_viewGet the current Kubernetes configuration content as a kubeconfig YAML
events_listList Kubernetes events (warnings, errors, state changes) for debugging and troubleshooting in the current cluster from all namespaces
namespaces_listList all the Kubernetes namespaces in the current cluster
projects_listList all the OpenShift projects in the current cluster
nodes_logGet logs from a Kubernetes node (kubelet, kube-proxy, or other system logs). This accesses node logs through the Kubernetes API proxy to the kubelet
nodes_stats_summaryGet detailed resource usage statistics from a Kubernetes node via the kubelet's Summary API. Provides comprehensive metrics including CPU, memory, filesystem, and network usage at the node, pod, and container levels. On
nodes_topList the resource consumption (CPU and memory) as recorded by the Kubernetes Metrics Server for the specified Kubernetes Nodes or all nodes in the cluster
ToolsetDescription
configView and manage the current local Kubernetes configuration (kubeconfig)
coreMost common tools for Kubernetes management (Pods, Generic Resources, Events, etc.)
helmTools for managing Helm charts and releases
kcpManage kcp workspaces and multi-tenancy features

How to install the Kubernetes MCP server

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

Configuration as documented by the project. Restart the client after saving.

Configuration

Example prompts to try

  • Use Kubernetes to configuration contexts list.
  • Use Kubernetes to targets list.
  • Use Kubernetes to configuration view.

Frequently asked questions

It connects Kubernetes to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (configuration_contexts_list, targets_list, configuration_view, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Kubernetes directly.