flux159/mcp-server-kubernetes

MCP Server Kubernetes 镜像文档

镜像概述和主要用途

MCP Server Kubernetes 是一个用于连接并管理 Kubernetes 集群的服务器镜像。它能够通过多种来源加载 kubeconfig 并自动连接到当前 kubectl 上下文，支持与 Claude Desktop、mcp-chat 等工具集成，实现通过自然语言交互管理 Kubernetes 集群资源。

核心功能和特性

• 集群连接与管理：自动连接当前 kubectl 上下文，支持管理各类 Kubernetes 集群（minikube、Rancher Desktop、GKE、AWS 等）
• 多来源 kubeconfig 加载：支持从多个来源按优先级加载 kubeconfig（默认路径、环境变量、自定义路径等）
• 全面的 kubectl 操作支持：
  • 资源管理：获取（kubectl_get）、描述（kubectl_describe）、创建（kubectl_create）、应用（kubectl_apply）、删除（kubectl_delete）资源
  • 集群操作：扩展资源（kubectl_scale）、更新资源字段（kubectl_patch）、管理部署滚动更新（kubectl_rollout）、执行通用 kubectl 命令（kubectl_generic）
  • 辅助功能：查看 API 资源（list_api_resources）、解释资源（explain_resource）、验证连接（ping）
• 高级操作：端口转发（port_forward）、Helm v3 操作（安装/升级/卸载图表，支持自定义值、仓库和版本）
• 故障排除：提供 k8s-diagnose 提示，系统化排查基于关键字和命名空间的 Pod 问题
• 非破坏性模式：支持只读和仅创建/更新的集群访问权限控制

使用场景和适用范围

适用于需要通过自然语言交互工具（如 Claude Desktop）或 CLI 聊天客户端（mcp-chat）管理 Kubernetes 集群的用户，支持开发测试环境（minikube、Rancher Desktop）和生产环境（GKE、AWS 等）集群，适合开发人员、运维人员进行集群资源管理、部署操作和故障排查。

使用方法和配置说明

前提条件

使用前需确保：

1. kubectl 已安装并添加到 PATH
2. 存在有效的 kubeconfig 文件并配置上下文
3. 已配置可通过 kubectl 访问的 Kubernetes 集群（如 minikube、Rancher Desktop、GKE 等）
4. Helm v3 已安装并添加到 PATH（可选，不使用 Helm 时无需安装）

与 Claude Desktop 配合使用

在 Claude Desktop 配置中添加以下 JSON：

json
{
  "mcpServers": {
    "kubernetes": {
      "command": "docker",
      "args": [
        "run", 
        "-i", 
        "--rm",
        "-v",
        "~/.kube:/home/appuser/.kube:ro", 
        "flux159/mcp-server-kubernetes:latest"
      ]
    }
  }
}

配置说明

• 默认从 ~/.kube/config 加载 kubeconfig
• 高级认证选项（环境变量、自定义路径等）详见 https://github.com/Flux159/mcp-server-kubernetes/blob/main/ADVANCED_README.md
• GKE、AWS 等生产集群可能需要传递环境变量或确保 kubeconfig 配置正确的凭证插件

与 mcp-chat 配合使用

https://github.com/Flux159/mcp-chat 是 MCP 服务器的 CLI 聊天客户端，使用命令：

shell
npx mcp-chat --server "npx mcp-server-kubernetes"

或通过配置文件使用（需替换为实际路径）：

• Mac：

  shell
  npx mcp-chat --config "~/Library/Application Support/Claude/claude_desktop_config.json"
  

• Windows：

  shell
  npx mcp-chat --config "%APPDATA%\Claude\claude_desktop_config.json"
  

连接验证和故障排除

• 验证连接：可让 Claude 列出 Pod 或创建测试部署来验证连接
• 故障排除：若出现错误，在终端运行 kubectl get pods 检查集群连接和凭证问题，确保无认证错误

高级配置

有关环境变量配置、自定义 kubeconfig 路径、云厂商集群（GKE、AWS 等）凭证设置等高级用法，参见 GitHub 上的 https://github.com/Flux159/mcp-server-kubernetes/blob/main/ADVANCED_README.md%E3%80%82