← 返回目录

Kubernetes MCP Server

社区

通过 kubectl 与 Kubernetes 集群交互的 MCP 服务器

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 108 / 438
Stars: ★ 1.6k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 无需凭据
许可证: MIT
最近提交: 10 天前
工具数: 23

61FMRS · C

该服务器功能强大，但需要谨慎使用，特别是在生产环境。建议启用非破坏性模式以减少风险。

最强项 · 文档质量 17/20 最弱项 · 安全与权限 3/20

可靠性

10/20

安全与权限

3/20

维护活跃度

16/20

文档质量

17/20

安装易用性

15/20

查看各项评分依据

可靠性 10/20: README 表明这是一个成熟的 npm 包（v2.9.4），声明了大量工具（kubectl_*、Helm、端口转发、清理、诊断）并带有 CI 徽章；提到 `bun run test`，但未提供已提交的测试文件或 CI 工作流，无法验证实际执行。因缺少可执行证据、错误处理文档薄弱，以及 README 中少量不一致（如 kubectl_get 名单重复、helm 相关工具命名不一致）而扣分。
安全与权限 3/20: 服务器通过 kubeconfig 路径或 YAML/JSON 环境变量读取集群凭据，并文档化了响应中的 secret 掩码；也提供了可选的只读/非破坏模式。但默认配置暴露破坏性工具（kubectl_delete、cleanup_pods、node_management drain、uninstall_helm_chart）以及 `kubectl_generic`（任意 kubectl 命令执行），且未描述任何服务端确认机制。这触发了“无确认的不可逆删除/远程命令默认值”红线，因此分数限制在 0-4；鉴于存在缓解措施但不是默认启用，给 3 分。
维护活跃度 16/20: MIT 许可证、1519 星、6 个未关闭 issue、未归档、文档化的发布流程、CI 徽章、CONTRIBUTING 页面以及版本化 npm 发布表明该项目处于持续维护状态。因缺少明确的安全响应渠道和可见的依赖更新证据，且维护者身份只在引用信息中出现而无专门维护者文件而扣分。
文档质量 17/20: README 提供了 Claude Code、Codex、Claude Desktop、VS Code、Cursor、mcp-chat 的安装示例；说明了 kubeconfig 加载、非破坏模式、可观测性、架构，并链接到 ADVANCED_README 和 docs 目录。缺少逐工具的参数说明、明确的限制和通用故障排查章节；安装前提依赖用户已有的 kubectl/kubeconfig 知识。综合扣分后给 17 分。
安装易用性 15/20: 安装基本是 `npx mcp-server-kubernetes`，并为六个主流客户端提供了明确配置片段；说明前提条件（kubectl、kubeconfig、集群、可选 Helm）并给出验证命令。静态校准要求在未提供可验证执行证据（真实 CI 与提交的测试）时 setup 最高给 15；且未覆盖平台特定问题或运行时验证，因此给 15 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么执行命令或代码访问网络

适合谁

使用 AI 助手进行 Kubernetes 集群管理的开发者和运维人员
需要快速故障排查和诊断 K8s 问题的场景
集成到 Claude Desktop、Codex CLI 等 MCP 客户端的用户

不适合谁

需要图形界面管理 Kubernetes 的用户
没有 kubectl 或 kubeconfig 的环境
需要精细 RBAC 控制但不信任 AI 助手的生产环境

所需权限

读取和修改 Kubernetes 资源（根据配置可能受限）
执行 kubectl 命令（包括创建、删除、更新资源）
访问 kubeconfig 文件以连接集群
可能执行端口转发和节点排空等操作

风险与副作用

意外删除或修改资源（可通过非破坏性模式降低风险）
暴露敏感信息（如 secrets，可通过秘密掩码降低）
权限过大可能导致集群配置错误或故障
未授权访问如果 kubeconfig 被泄露

安装接入

准备工作

运行环境：Node.js

其他可选配置项（12 个）

ALLOW_ONLY_NON_DESTRUCTIVE_TOOLS 可选设为 true 启用非破坏性模式，禁用删除类操作。

ALLOW_ONLY_READONLY_TOOLS 可选设为 true 启用只读模式。

ALLOWED_TOOLS 可选逗号分隔的允许工具列表，用于限制可用工具。

MASK_SECRETS 可选设为 false 可关闭响应中敏感信息的自动掩码。

ENABLE_UNSAFE_STREAMABLE_HTTP_TRANSPORT 可选启用 Streamable HTTP 传输方式。

ENABLE_UNSAFE_SSE_TRANSPORT 可选启用 SSE 传输方式。

KUBECONFIG_YAML 可选以 YAML 字符串形式提供 kubeconfig。

KUBECONFIG_JSON 可选以 JSON 字符串形式提供 kubeconfig。

KUBECONFIG_PATH 可选指定 kubeconfig 文件路径，默认 ~/.kube/config。

ENABLE_TELEMETRY 可选设为 true 开启 OpenTelemetry 可观测性。

OTEL_EXPORTER_OTLP_ENDPOINT 可选 OTLP 后端（如 Jaeger）的追踪数据导出地址。

OTEL_TRACES_SAMPLER 可选追踪采样策略，如 always_on。

确保已安装 kubectl 并配置好 kubeconfig。
使用 npx 或客户端集成添加服务器。例如：npx mcp-server-kubernetes。
根据客户端配置（如 Claude Desktop、VS Code 等）添加相应的 mcpServers 配置。

.mcp.json

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

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "kubernetes": {
      "command": "npx",
      "args": [
        "mcp-server-kubernetes"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add kubernetes -- npx mcp-server-kubernetes

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端中确认 kubernetes 服务器的工具列表中出现了 kubectl_get 和 ping 等工具，然后让 AI 列出你的 Pod，若能返回集群中的 Pod 列表即说明连接成功。

常见排障

运行 kubectl get pods 验证连接
检查 kubeconfig 路径是否正确
确保 kubectl 在 PATH 中
查看服务器日志以获取错误信息
确保环境变量（如 KUBECONFIG_PATH）设置正确

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出当前命名空间里的所有 Pod
帮我创建一个 nginx 部署并应用它
查看 my-pod 的日志并诊断为什么它处于 CrashLoopBackOff 状态
把 my-deployment 扩容到 3 个副本

工具能力 23

kubectl_get 只读

获取或列出 Kubernetes 资源（如 pods、deployments、services）

kubectl_describe 只读

详细描述 Kubernetes 资源的状态和事件

kubectl_create 写入

创建 Kubernetes 资源

kubectl_apply 写入

应用 YAML 清单创建或更新资源

kubectl_delete 破坏性

删除 Kubernetes 资源

kubectl_logs 只读

获取 Pod 的日志

kubectl_context 只读

管理 kubectl 上下文（查看、切换、设置当前上下文）

explain_resource 只读

解释 Kubernetes 资源的字段和结构

展开其余 15 个工具

list_api_resources 只读

列出集群支持的 API 资源

kubectl_scale 写入

扩缩容资源（如 Deployment）

kubectl_patch 写入

更新资源的部分字段

kubectl_rollout 写入

管理部署的 rollout（状态、重启、回滚）

kubectl_generic 写入

执行任意 kubectl 命令

ping 只读

验证与集群的连接

port_forward 写入

将本地端口转发到 Pod 或 Service

stop_port_forward 写入

停止端口转发

install_helm_chart 写入

安装 Helm chart

upgrade_helm_chart 写入

升级 Helm chart

uninstall_helm_chart 破坏性

卸载 Helm chart

helm_template_apply 写入

通过模板渲染并应用 Helm chart（绕过认证问题）

helm_template_uninstall 破坏性

通过模板渲染并卸载 Helm chart（绕过认证问题）

cleanup_pods 破坏性

清理问题 Pod（如 Evicted、Error、CrashLoopBackOff 等）

node_management 写入

节点管理操作（隔离、排空、取消隔离）

使用场景

通过自然语言管理 Kubernetes 资源

自动化集群故障排查

执行 Helm Chart 的安装、升级和卸载

管理节点维护操作

端口转发访问集群内服务

支持客户端

Claude Code

Claude Desktop

Codex

Cursor

VS Code

依据项目文档列出，未经本站实测。

详细介绍

mcp-server-kubernetes 是一个 MCP 服务器，允许 AI 助手通过 kubectl 与 Kubernetes 集群进行交互。它支持从多个来源加载 kubeconfig，并提供丰富的工具用于管理资源、执行 Helm 操作、端口转发、节点管理等。该服务器支持非破坏性模式和只读模式，并包含秘密掩码以增强安全性。