mcp-server-kubernetes

mcp-server-kubernetes 是由开源社区 Flux159 开发的 Kubernetes MCP（Model Context Protocol）服务器。它将 kubectl 命令行能力封装为 AI 编程工具可调用的 MCP 工具，让 Claude Code、Codex、Cursor 等 AI 编码助手直接操控 Kubernetes 集群——无需记忆复杂命令，用自然语言即可完成 Pod 管理、日志查看、Helm 部署、节点维护等操作。

该工具于 2024 年上线，至今保持活跃维护，GitHub 获星 1579 个，近期（2026-09-14）刚发布 v4.1.7 版本，是目前功能最全面的 K8s MCP 服务器之一。

核心能力

提供七大类工具：kubectl 统一操作 API（kubectl_get/describe/apply/delete/logs/scale/patch/rollout）、Helm 包管理（install/upgrade/uninstall/templated 操作）、Pod 运维自动化（异常状态清理、端口转发）、节点管理（cordon/drain/uncordon）、多集群上下文切换、非破坏安全模式（禁用删除操作）、以及 OpenTelemetry 可观测性和 k8s-diagnose 故障排查提示词。

安装配置

前置依赖：kubectl + kubeconfig + Helm v3（可选）。Claude Code 用户运行 claude mcp add kubernetes -- npx mcp-server-kubernetes；Codex 用户运行 codex mcp add kubernetes -- npx mcp-server-kubernetes；Claude Desktop 在配置文件中添加 mcpServers.kubernetes 条目；Cursor 在 .cursor/mcp.json 中配置。

使用步骤

1. 用 kubectl get pods 验证集群连接
2. 根据 IDE 配置 MCP 服务器
3. 用自然语言操作集群（查看 Pod、部署应用、获取日志、清理异常 Pod）
4. 使用 Helm 部署应用（helm install my-release bitnami/nginx）
5. 可选启用 OpenTelemetry 追踪（设置 ENABLE_TELEMETRY=true）

适用场景

AI 辅助开发、CI/CD 自动化、故障排查、集群维护、Helm 运维、多集群管理。

适用人群

Kubernetes 开发者、DevOps 工程师、全栈工程师、K8s 初学者。

工作原理

基于 MCP 协议：AI 编码工具通过 MCP（stdio/HTTP）发送请求 → mcp-server-kubernetes 转换为 kubectl/Helm 命令 → Kubernetes API Server 执行 → 结果结构化返回 AI。OpenTelemetry SDK 内嵌，工具层自动生成追踪 span，支持 Jaeger/Tempo/Datadog 等后端。

官方链接

GitHub：https://github.com/Flux159/mcp-server-kubernetes | npm：https://www.npmjs.com/package/mcp-server-kubernetes