# Kubernetes MCP Server (MCP server)

> Kubernetes MCP Server is an MCP server that adds cloud and DevOps tools to AI assistants such as Claude Desktop, Claude Code and Cursor. A Model Context Protocol (MCP) server for Kubernetes and OpenShift. It has 2,147 GitHub stars, is released under the Apache-2.0 license and runs locally with npx -y kubernetes-mcp-server.

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

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/containers/kubernetes-mcp-server |
| GitHub stars | 2,147 |
| License | Apache-2.0 |
| Language | Go |
| Transport | stdio |
| Packages | npm: kubernetes-mcp-server; pypi: kubernetes-mcp-server |
| Remote URL | none |
| Needs API key | no |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Cloud & DevOps |
| Latest release | v0.0.67 (Sep 18, 2026) |
| Last commit | Oct 6, 2026 |
| MCP registry name | io.github.containers/kubernetes-mcp-server |

## Install

### Claude Desktop (claude_desktop_config.json)

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

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --transport stdio kubernetes-mcp-server -- npx -y kubernetes-mcp-server
```

### Cursor (.cursor/mcp.json)

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

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

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

Config formats checked against the official docs on 2026-10-07.

## Tools

- `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
- `minified`: Return a minified version of the configuration. If set to true, keeps only the current-context and the relevant pieces…
- `events_list`: List Kubernetes events (warnings, errors, state changes) for debugging and troubleshooting in the current cluster from…
- `namespace`: Optional Namespace to retrieve the events from. If not provided, will list events 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).
- `query`: (required) - query specifies services(s) or files from which to return logs (required).
- `nodes_stats_summary`: Get detailed resource usage statistics from a Kubernetes node via the kubelet's Summary API.
- `nodes_top`: List the resource consumption (CPU and memory) as recorded by the Kubernetes Metrics Server for the specified…
- `label_selector`: Kubernetes label selector (e.g. 'node-role.kubernetes.io/worker=') to filter nodes by label (Optional, only applicable…
- `pods_list`: List all the Kubernetes pods in the current cluster from all namespaces
- `pods_list_in_namespace`: List all the Kubernetes pods in the specified namespace in the current cluster
- `pods_get`: Get a Kubernetes Pod in the current or provided namespace with the provided name
- `pods_delete`: Delete a Kubernetes Pod in the current or provided namespace with the provided name
- `pods_top`: List the resource consumption (CPU and memory) as recorded by the Kubernetes Metrics Server for the specified…
- `all_namespaces`: If true, list the resource consumption for all Pods in all namespaces.
- `pods_exec`: Execute a command in a Kubernetes Pod (shell access, run commands in container) in the current or provided namespace…
- `command`: (required) - Command to execute in the Pod container. The first item is the command to be run, and the rest are the…
- `container`: Name of the Pod container where the command will be executed (Optional)
- `pods_log`: Get the logs of a Kubernetes Pod in the current or provided namespace with the provided name
- `previous`: Return previous terminated container logs (Optional)
- `tail`: Number of lines to retrieve from the end of the logs (Optional, default: 100)
- `pods_run`: Run a Kubernetes Pod in the current or provided namespace with the provided container image and optional name
- `image`: (required) - Container Image to run in the Pod
- `port`: TCP/IP port to expose from the Pod container (Optional, no port exposed if not provided)
- `resources_list`: List Kubernetes resources and objects in the current cluster by providing their apiVersion and kind and optionally the…
- `kind`: (required) - kind of the resources (examples of valid kind are: Pod, Service, Deployment, Ingress)
- `resources_get`: Get a Kubernetes resource in the current cluster by providing its apiVersion, kind, optionally the namespace, and its…
- `resources_create_or_update`: Create or update a Kubernetes resource via Server-Side Apply. The manifest is the complete desired state: any field…
- `resource`: (required) - Complete YAML or JSON representation of the Kubernetes resource (full desired state, not a partial…
- `resources_delete`: Delete a Kubernetes resource in the current cluster by providing its apiVersion, kind, optionally the namespace, and…
- `resources_scale`: Get or update the scale of a Kubernetes resource in the current cluster by providing its apiVersion, kind, name, and…
- `scale`: Optional scale to update the resources scale to. If not provided, will return the current scale of the resource, and…
- `helm_install`: Install (deploy) a Helm chart to create a release in the current or provided namespace
- `chart`: (required) - Chart reference to install (for example: stable/grafana, oci://ghcr.io/nginxinc/charts/nginx-ingress)
- `values`: Values to pass to the Helm chart (Optional)
- `helm_list`: List all the Helm releases in the current or provided namespace (or in all namespaces if specified)

## Similar MCP servers

- [Worldmonitor](https://appsgit.com/mcp-servers/worldmonitor): Real-time global intelligence dashboard. AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface. (87,920 stars, AGPL-3.0)
- [Netdata](https://appsgit.com/mcp-servers/netdata): Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection. (80,817 stars, GPL-3.0, needs API key)
- [openstatus](https://appsgit.com/mcp-servers/openstatus): Manage monitors, status pages, incidents and maintenances in your openstatus workspace. (9,171 stars, AGPL-3.0, official)
- [MCP Server Cloudflare](https://appsgit.com/mcp-servers/mcp-server-cloudflare): Model Context Protocol (MCP) is a new, standardized protocol for managing context between large language models (LLMs) and external systems. (4,360 stars, Apache-2.0, official, needs API key)
- [Dagu](https://appsgit.com/mcp-servers/dagu): Self-hostable workflow orchestrator for teams whose main work isn't orchestration. (4,289 stars, GPL-3.0)
- [Azure MCP Server](https://appsgit.com/mcp-servers/azure-mcp-server): All Azure MCP tools to create a seamless connection between AI agents and Azure services. (3,738 stars, MIT, official)

---

Canonical page: https://appsgit.com/mcp-servers/kubernetes-mcp-server
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.
