# mcp-k8s — Kubernetes MCP Server (Go + Helm)

> A Go-based Kubernetes MCP server supporting resource CRUD (configurable) plus Helm ops and multiple transports; verified 145★, pushed 2026-04-12.

## Install

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

## Quick Use

```bash
go install github.com/silenceper/mcp-k8s/cmd/mcp-k8s@latest
# Or run via Docker (README):
docker run --rm -p 8080:8080 -i -v ~/.kube/config:/root/.kube/config ghcr.io/silenceper/mcp-k8s:latest --transport=streamable-http --endpoint-path=/mcp
# Connect MCP client to: http://localhost:8080/mcp
```

## Intro

A Go-based Kubernetes MCP server supporting resource CRUD (configurable) plus Helm ops and multiple transports; verified 145★, pushed 2026-04-12.

**Best for:** Ops/dev teams who want LLM-friendly Kubernetes reads (and gated writes) via MCP tools

**Works with:** Go 1.21+ or Docker; reads kubeconfig and can run over stdio/SSE/Streamable HTTP (README)

**Setup time:** 12-25 minutes

### Key facts (verified)

- GitHub: 145 stars · 28 forks · pushed 2026-04-12.
- License: Apache-2.0 · owner avatar + repo URL verified via GitHub API.
- README-backed entrypoint: `go install github.com/silenceper/mcp-k8s/cmd/mcp-k8s@latest`.

## Main

- Start read-only: keep create/update/delete disabled until you trust your prompts and role separation (README shows write flags).

- Choose a transport that matches your client: use stdio for desktop clients, or Streamable HTTP/SSE for remote access and debugging.

- Keep kubeconfig explicit: Docker examples mount `~/.kube/config` so the server talks to the cluster you intend.

- Use Helm tools for higher-level ops: `list_helm_releases`/`install_helm_chart`/`upgrade_helm_chart` help avoid low-level manifest edits.

### Source-backed notes

- README lists tool groups: Kubernetes resource queries/CRUD plus Helm release/repo operations.
- README includes Docker run examples exposing `http://localhost:8080/mcp` in Streamable HTTP mode.
- README shows install via `go install github.com/silenceper/mcp-k8s/cmd/mcp-k8s@latest` and mentions downloading binaries from releases.

### FAQ

- **Can it modify my cluster?**: Yes, but writes are configurable; keep create/update/delete disabled unless you need them (README flags).
- **Which transport should I use?**: Use Streamable HTTP for URL-based clients and debugging; use stdio for local desktop MCP clients.
- **How does it find my cluster credentials?**: README Docker examples mount `~/.kube/config`; Go binary can read a kubeconfig path via flags.

## Source & Thanks

> Source: https://github.com/silenceper/mcp-k8s
> License: Apache-2.0
> GitHub stars: 145 · forks: 28

---

<!-- ZH -->

## Quick Use

```bash
go install github.com/silenceper/mcp-k8s/cmd/mcp-k8s@latest
# Or run via Docker (README):
docker run --rm -p 8080:8080 -i -v ~/.kube/config:/root/.kube/config ghcr.io/silenceper/mcp-k8s:latest --transport=streamable-http --endpoint-path=/mcp
# Connect MCP client to: http://localhost:8080/mcp
```

## Intro

mcp-k8s 是 Go 实现的 Kubernetes MCP server：资源增删改查可配置开关，且支持 Helm 操作与多种传输模式，便于安全接入；已验证 145★，更新于 2026-04-12。

**Best for:** 希望用 MCP 工具让 LLM 读 K8s 资源，并对写操作做开关控制的团队

**Works with:** 可用 Go 安装或 Docker 运行；读取 kubeconfig，支持 stdio/SSE/Streamable HTTP（README）

**Setup time:** 12-25 minutes

### Key facts (verified)

- GitHub：145 stars · 28 forks；最近更新 2026-04-12。
- 许可证：Apache-2.0；作者头像与仓库链接均已通过 GitHub API 复核。
- README 中可对照的入口命令：`go install github.com/silenceper/mcp-k8s/cmd/mcp-k8s@latest`。

## Main

- 默认先只读：在你确认提示词与权限边界前，不要开启 create/update/delete（README 有写操作开关）。

- 按客户端选 transport：桌面客户端用 stdio，远程/调试用 Streamable HTTP 或 SSE 更直观。

- 显式指定 kubeconfig：Docker 示例通过挂载 `~/.kube/config`，避免连错集群。

- 用 Helm 工具做高层操作：`list_helm_releases`/`install_helm_chart`/`upgrade_helm_chart` 能减少直接改 YAML 的风险。

### Source-backed notes

- README 列出工具分组：K8s 资源查询/CRUD + Helm release/repo 管理。
- README 给出 Streamable HTTP 模式 Docker 示例，并暴露 `http://localhost:8080/mcp`。
- README 给出 `go install github.com/silenceper/mcp-k8s/cmd/mcp-k8s@latest`，也提到可从 releases 下载二进制。

### FAQ

- **会改动我的集群吗？**：可以，但写操作可开关；除非必要，否则建议只读（README flags）。
- **该用哪种传输模式？**：URL 客户端与调试优先 Streamable HTTP；本地桌面客户端优先 stdio。
- **集群凭证从哪里来？**：README 的 Docker 例子挂载 `~/.kube/config`；Go 二进制可通过参数指定 kubeconfig。

## Source & Thanks

> Source: https://github.com/silenceper/mcp-k8s
> License: Apache-2.0
> GitHub stars: 145 · forks: 28


---
Source: https://tokrepo.com/en/workflows/mcp-k8s-kubernetes-mcp-server-go-helm
Author: MCP Hub