# mcp-server-kubernetes — Kubernetes Ops via MCP

> MCP server that lets agents run kubectl/Helm workflows against your clusters; works with Claude Code via npx; verified 1390★, pushed 2026-05-03.

## Install

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

## Quick Use

```bash
kubectl get pods # verify kubeconfig works
claude mcp add kubernetes -- npx mcp-server-kubernetes
# Claude Desktop MCP config also supports:
# {"command":"npx","args":["mcp-server-kubernetes"]}
```

## Intro

MCP server that lets agents run kubectl/Helm workflows against your clusters; works with Claude Code via npx; verified 1390★, pushed 2026-05-03.

**Best for:** Platform/SRE teams who want a safe, repeatable agent interface for cluster ops (kubectl + optional Helm)

**Works with:** kubectl + kubeconfig contexts; optional Helm v3; MCP clients like Claude Code / Claude Desktop (npx)

**Setup time:** 12-25 minutes

### Key facts (verified)

- GitHub: 1390 stars · 243 forks · pushed 2026-05-03.
- License: MIT · owner avatar + repo URL verified via GitHub API.
- README-backed entrypoint: `claude mcp add kubernetes -- npx mcp-server-kubernetes`.

## Main

- Use it for controlled kubectl workflows: standardize read-only checks first (get/describe/logs) before enabling mutation paths in your agent policy.

- Make context explicit: keep clusters/namespaces in the prompt and validate with `kubectl config current-context` to avoid “wrong cluster” incidents.

- Treat Helm as optional: README lists Helm v3 as optional unless you plan to use Helm operations.

- Pair with audit logging: keep kubectl audit logs and MCP client logs so you can attribute every agent action to a human request.

### Source-backed notes

- README prerequisites list kubectl + kubeconfig contexts and notes Helm v3 is optional.
- README shows adding it to Claude Code via: `claude mcp add kubernetes -- npx mcp-server-kubernetes`.
- README provides example MCP configs for Claude Desktop using `npx`.

### FAQ

- **Do I need Helm installed?**: Only if you plan to use Helm operations; README lists Helm v3 as optional.
- **Where does it load kubeconfig from?**: README says it loads from `~/.kube/config` by default, with advanced options documented.
- **What’s the safest first use?**: Start with read-only cluster queries (pods/services/events) before attempting changes.

## Source & Thanks

> Source: https://github.com/flux159/mcp-server-kubernetes
> License: MIT
> GitHub stars: 1390 · forks: 243

---

<!-- ZH -->

## Quick Use

```bash
kubectl get pods # verify kubeconfig works
claude mcp add kubernetes -- npx mcp-server-kubernetes
# Claude Desktop MCP config also supports:
# {"command":"npx","args":["mcp-server-kubernetes"]}
```

## Intro

mcp-server-kubernetes 让 agent 通过 MCP 操作 Kubernetes：依赖 kubeconfig，支持 kubectl/Helm，Claude Code 可用 npx 一键接入；已验证 1390★，更新于 2026-05-03。

**Best for:** 希望把集群运维（kubectl/Helm）变成可复用 agent 工具面的平台/SRE 团队

**Works with:** kubectl + kubeconfig；可选 Helm v3；Claude Code / Claude Desktop 等 MCP 客户端（npx）

**Setup time:** 12-25 minutes

### Key facts (verified)

- GitHub：1390 stars · 243 forks；最近更新 2026-05-03。
- 许可证：MIT；作者头像与仓库链接均已通过 GitHub API 复核。
- README 中可对照的入口命令：`claude mcp add kubernetes -- npx mcp-server-kubernetes`。

## Main

- 先把只读运维流程标准化：优先做 get/describe/logs 等检查，再在策略层逐步放开变更类操作。

- 上下文必须显式：在提示词里写清 cluster/namespace，并用 `kubectl config current-context` 交叉确认，避免误操作到错误集群。

- Helm 是可选项：README 说明 Helm v3 仅在需要 Helm 操作时才必须安装。

- 配合审计：保留 kube-apiserver audit logs 与 MCP 客户端日志，确保每次 agent 操作都可追溯到人类请求。

### Source-backed notes

- README 的 prerequisites 要求 kubectl + kubeconfig，并说明 Helm v3 是可选。
- README 给出 Claude Code 接入命令：`claude mcp add kubernetes -- npx mcp-server-kubernetes`。
- README 提供 Claude Desktop 通过 `npx` 配置 MCP 的示例。

### FAQ

- **必须安装 Helm 吗？**：不一定；README 说明 Helm v3 仅在需要 Helm 操作时才必须。
- **默认从哪里读取 kubeconfig？**：README 表示默认读取 `~/.kube/config`，高级选项见其文档。
- **最安全的起步方式？**：先做只读查询（pods/services/events），确认上下文无误后再考虑变更。

## Source & Thanks

> Source: https://github.com/flux159/mcp-server-kubernetes
> License: MIT
> GitHub stars: 1390 · forks: 243


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