# kubernetes-mcp-server — Kubernetes Tools via MCP

> kubernetes-mcp-server exposes Kubernetes operations to MCP clients with npx/uvx/binary run modes; verified 1584★ and pushed 2026-05-14.

## Install

Merge the JSON below into your `.mcp.json`:

## Quick Use

```bash
npx kubernetes-mcp-server@latest --help
# Or: uvx kubernetes-mcp-server@latest --help
# Then configure your MCP client to run it with your kubeconfig / env.
```

## Intro

kubernetes-mcp-server exposes Kubernetes operations to MCP clients with npx/uvx/binary run modes; verified 1584★ and pushed 2026-05-14.

**Best for:** DevOps and platform teams who want natural-language Kubernetes diagnosis with a controllable tool boundary

**Works with:** Node.js (npx) or Python+uv (uvx), plus access to a kubeconfig / in-cluster credentials

**Setup time:** 10-25 minutes

### Key facts (verified)

- GitHub: 1584 stars · 339 forks · pushed 2026-05-14.
- License: Apache-2.0 · owner avatar + repo URL verified via GitHub API.
- README-backed entrypoint: `npx kubernetes-mcp-server@latest --help`.

## Main

- Multiple run modes: README shows `npx`, `uvx`, and a release binary for running the server CLI.

- Safer defaults for ops: README documents flags like read-only and disabling destructive operations to reduce blast radius.

- HTTP + SSE support: README notes Streamable HTTP mode and SSE endpoints when running with `--port`.

- Kubeconfig-aware: README includes config options for kubeconfig resolution and cluster provider strategies.

### Source-backed notes

- README includes `npx kubernetes-mcp-server@latest --help` and `uvx kubernetes-mcp-server@latest --help` examples.
- README lists CLI options for read-only and disabling destructive operations, and notes HTTP/SSE endpoints when using `--port`.
- README provides client configuration examples for multiple MCP clients (Claude Desktop, VS Code, Cursor).

### FAQ

- **Can I run it read-only?**: Yes — README documents a `--read-only` mode and other safety flags.
- **Do I need a Kubernetes cluster?**: You need credentials (kubeconfig or in-cluster auth) to a cluster you can query.
- **Is npx required?**: No — README also supports `uvx` and a release binary.

## Source & Thanks

> Source: https://github.com/containers/kubernetes-mcp-server
> License: Apache-2.0
> GitHub stars: 1584 · forks: 339

---

<!-- ZH -->

## Quick Use

```bash
npx kubernetes-mcp-server@latest --help
# Or: uvx kubernetes-mcp-server@latest --help
# Then configure your MCP client to run it with your kubeconfig / env.
```

## Intro

kubernetes-mcp-server 将 Kubernetes 操作能力暴露给 MCP 客户端，支持 npx/uvx/二进制多种运行方式；已验证 1584★，最近更新 2026-05-14。

**Best for:** 想用自然语言做 K8s 诊断/查询，并能严格控制工具边界的 DevOps/平台团队

**Works with:** Node.js（npx）或 Python+uv（uvx），以及 kubeconfig 或 in-cluster 凭据

**Setup time:** 10-25 minutes

### Key facts (verified)

- GitHub：1584 stars · 339 forks；最近更新 2026-05-14。
- 许可证：Apache-2.0；作者头像与仓库链接均已通过 GitHub API 复核。
- README 中可对照的入口命令：`npx kubernetes-mcp-server@latest --help`。

## Main

- 多种运行方式：README 同时给出 `npx`、`uvx` 与 release 二进制启动方式。

- 运维安全阀：README 提供只读与禁用破坏性操作等开关，适合先观测后操作。

- 支持 HTTP + SSE：README 说明 `--port` 可开启 Streamable HTTP（/mcp）与 SSE（/sse）。

- Kubeconfig 适配：README 有 kubeconfig 解析与配置项，适配本地与集群内运行。

### Source-backed notes

- README 给出 `npx kubernetes-mcp-server@latest --help` 与 `uvx ... --help` 示例。
- README 列出只读/禁用破坏性操作等参数，并说明 `--port` 对应的 HTTP/SSE endpoint。
- README 提供多种 MCP 客户端的配置示例（Claude Desktop、VS Code、Cursor 等）。

### FAQ

- **能不能只读运行？**：可以。README 提供 `--read-only` 等安全模式。
- **必须有集群吗？**：需要能访问的集群与凭据（kubeconfig 或 in-cluster）。
- **必须用 npx 吗？**：不必。README 也支持 `uvx` 与 release 二进制。

## Source & Thanks

> Source: https://github.com/containers/kubernetes-mcp-server
> License: Apache-2.0
> GitHub stars: 1584 · forks: 339


---
Source: https://tokrepo.com/en/workflows/kubernetes-mcp-server-kubernetes-tools-via-mcp
Author: MCP Hub