Kubernetes MCP Server 使用说明

项目简介

Kubernetes MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 客户端提供与 Kubernetes 集群交互的能力。通过此服务器，LLM 客户端可以安全、可扩展地获取 Kubernetes 集群的上下文信息，并执行管理操作，从而实现更智能的云原生应用管理和自动化。

主要功能点

查看 Kubernetes 配置: 允许 LLM 客户端查看当前 Kubernetes 集群的 kubeconfig 配置文件内容。
通用 Kubernetes 资源操作: 支持对 Kubernetes 集群中几乎所有类型的资源进行常见的 CRUD (创建、读取、更新、删除) 操作。
Pod 专用操作: 提供了针对 Kubernetes Pod 的特定操作，例如：
- 列出所有或特定命名空间中的 Pod。
- 获取指定名称的 Pod 信息。
- 删除指定名称的 Pod。
- 查看指定 Pod 的日志。
- 在 Pod 中运行新的容器镜像，并可选择暴露端口。

安装步骤

本 Kubernetes MCP Server 主要通过 'npx' 方式快速启动，无需显式安装步骤，尤其适用于 Claude Desktop 和 Goose CLI 等 MCP 客户端。

前提条件: 确保您的环境中已安装 Node.js 和 npm (Node Package Manager)。

使用 npx 启动 (推荐):

您无需手动下载或安装 Kubernetes MCP Server。
当 MCP 客户端（如 Claude Desktop 或 Goose CLI）需要连接 Kubernetes MCP Server 时，它将自动通过 'npx' 命令下载并运行 'kubernetes-mcp-server' npm 包。

服务器配置

MCP 客户端需要配置 Kubernetes MCP Server 的启动命令和参数才能建立连接。以下是针对 Claude Desktop 和 Goose CLI 的配置示例，均为 JSON 格式，您需要将这些配置添加到客户端的配置文件中。

针对 Claude Desktop 的配置 (添加到 'claude_desktop_config.json' 的 'mcpServers' 字段):

{
  "kubernetes": {
    "command": "npx",
    "args": [
      "-y",
      "kubernetes-mcp-server@latest"
    ]
  }
}

配置参数说明:

'"kubernetes"': 服务器名称，您可以自定义，用于在 Claude Desktop 客户端中标识此 MCP 服务器连接。
'"command": "npx"': 指定启动 MCP 服务器的命令为 'npx'，它用于执行 npm 包。
'"args": [...]"': 传递给 'npx' 命令的参数列表：
- '"-y"': (可选) 自动确认安装 'kubernetes-mcp-server' 包，避免在首次运行时出现交互式提示。
- '"kubernetes-mcp-server@latest"': 指定要运行的 npm 包为 'kubernetes-mcp-server'，'@latest' 表示使用最新版本。

针对 Goose CLI 的配置 (添加到 'config.yaml' 的 'extensions' 字段):

extensions:
  kubernetes:
    command: npx
    args:
      - -y
      - kubernetes-mcp-server@latest