适合谁
- 使用 AI 助手进行 Kubernetes 集群管理的开发者和运维人员
- 需要快速故障排查和诊断 K8s 问题的场景
- 集成到 Claude Desktop、Codex CLI 等 MCP 客户端的用户
K
61FMRS · C
该服务器功能强大，但需要谨慎使用，特别是在生产环境。建议启用非破坏性模式以减少风险。
mcp-server-kubernetes 是一个 MCP 服务器，允许 AI 助手通过 kubectl 与 Kubernetes 集群进行交互。它支持从多个来源加载 kubeconfig，并提供丰富的工具用于管理资源、执行 Helm 操作、端口转发、节点管理等。该服务器支持非破坏性模式和只读模式，并包含秘密掩码以增强安全性。
工具能力
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 资源的字段和结构
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
节点管理操作（隔离、排空、取消隔离）
安装接入
- 确保已安装 kubectl 并配置好 kubeconfig。2. 使用 npx 或客户端集成添加服务器。例如：npx mcp-server-kubernetes。3. 根据客户端配置（如 Claude Desktop、VS Code 等）添加相应的 mcpServers 配置。
claude_desktop_config.json
{
"mcpServers": {
"kubernetes": {
"command": "npx",
"args": [
"mcp-server-kubernetes"
]
}
}
}
选型与风险
不适合谁
- 需要图形界面管理 Kubernetes 的用户
- 没有 kubectl 或 kubeconfig 的环境
- 需要精细 RBAC 控制但不信任 AI 助手的生产环境
所需权限
- 读取和修改 Kubernetes 资源（根据配置可能受限）
- 执行 kubectl 命令（包括创建、删除、更新资源）
- 访问 kubeconfig 文件以连接集群
- 可能执行端口转发和节点排空等操作
风险与副作用
- 意外删除或修改资源（可通过非破坏性模式降低风险）
- 暴露敏感信息（如 secrets，可通过秘密掩码降低）
- 权限过大可能导致集群配置错误或故障
- 未授权访问如果 kubeconfig 被泄露
常见排障
- 运行 kubectl get pods 验证连接
- 检查 kubeconfig 路径是否正确
- 确保 kubectl 在 PATH 中
- 查看服务器日志以获取错误信息
- 确保环境变量（如 KUBECONFIG_PATH）设置正确
使用场景
通过自然语言管理 Kubernetes 资源
自动化集群故障排查
执行 Helm Chart 的安装、升级和卸载
管理节点维护操作
端口转发访问集群内服务
支持客户端
Claude Code完整支持
Claude Desktop完整支持
Codex CLI完整支持
Cursor完整支持
VS Code完整支持