Kubernetes MCP 服务器

✨ 功能 | 🚀 快速开始 | 🎥 演示 | ⚙️ 配置 | 🧑‍💻 开发

https://github.com/user-attachments/assets/be2b67b3-fc1c-4d11-ae46-93deba8ed98e

✨ 功能 <a id="features"></a>

一个强大且灵活的 Kubernetes 模型上下文协议 (MCP) 服务器实现，支持 Kubernetes 和 OpenShift。

• ✅ 配置:
  • 自动检测 Kubernetes 配置中的更改并更新 MCP 服务器。
  • 查看和管理当前的 Kubernetes .kube/config 或集群内配置。
• ✅ 通用 Kubernetes 资源: 对任何 Kubernetes 或 OpenShift 资源执行操作。
  • 任何 CRUD 操作（创建或更新、获取、列表、删除）。
• ✅ Pods: 执行 Pod 特定的操作。
  • 列出所有命名空间或特定命名空间中的 Pod。
  • 从指定的命名空间中获取按名称查找的 Pod。
  • 从指定的命名空间中删除按名称查找的 Pod。
  • 显示来自指定命名空间的按名称查找的 Pod 的日志。
  • Exec 进入 Pod 并运行命令。
  • 运行 Pod 中的容器镜像，并可选择公开它。
• ✅ 命名空间: 列出 Kubernetes 命名空间。
• ✅ 事件: 查看所有命名空间或特定命名空间中的 Kubernetes 事件。
• ✅ 项目: 列出 OpenShift 项目。

与其他 Kubernetes MCP 服务器实现不同，这不是 kubectl 或 helm 命令行工具的简单包装器。

无需在系统上安装外部依赖项或工具。 如果您使用的是原生二进制文件，甚至不需要在系统上安装 Node 或 Python。

🚀 快速开始 <a id="getting-started"></a>

要求

• 访问 Kubernetes 集群。

Claude Desktop

使用 npx

如果您已安装 npm，这是在 Claude Desktop 上开始使用 kubernetes-mcp-server 的最快方法。

打开您的 claude_desktop_config.json 并将 mcp 服务器添加到 mcpServers 列表中：

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

VS Code / VS Code Insiders

通过按以下链接在 VS Code Insiders 中安装 Kubernetes MCP 服务器扩展：

<img alt="在 VS Code Insiders 中安装" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=安装服务器&color=24bfa5">

或者，您可以通过运行以下命令手动安装扩展：

# 对于 VS Code
code --add-mcp '{"name":"kubernetes","command":"npx","args":["kubernetes-mcp-server@latest"]}'
# 对于 VS Code Insiders
code-insiders --add-mcp '{"name":"kubernetes","command":"npx","args":["kubernetes-mcp-server@latest"]}'

Goose CLI

Goose CLI 是开始使用人工智能 (AI) 代理的最简单（也是最便宜）的方法。

使用 npm

如果您已安装 npm，这是开始使用 kubernetes-mcp-server 的最快方法。

打开您的 goose config.yaml 并将 mcp 服务器添加到 mcpServers 列表中：

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

🎥 演示 <a id="demos"></a>

诊断并自动修复 OpenShift Deployment

演示展示了 Claude Desktop 如何利用 Kubernetes MCP 服务器自动诊断和修复 OpenShift 中的 Deployment，而无需任何用户协助。

https://github.com/user-attachments/assets/a576176d-a142-4c19-b9aa-a83dc4b8d941

Vibe Coding 一个简单的游戏并将其部署到 OpenShift

在此演示中，我将引导您完成使用 VS Code Vibe Coding 一个简单游戏的过程，以及如何利用 Podman MCP 服务器 和 Kubernetes MCP 服务器将其部署到 OpenShift。

<a href="https://www.youtube.com/watch?v=l05jQDSrzVI" target="_blank"> <img src="docs/images/vibe-coding.jpg" alt="Vibe Coding: 在 Kubernetes 上构建和部署游戏" width="240" /> </a>

⚙️ 配置 <a id="configuration"></a>

可以使用命令行 (CLI) 参数配置 Kubernetes MCP 服务器。

您可以使用 npx 运行 CLI 可执行文件，也可以下载最新版本二进制文件。

# 使用 npx 运行 Kubernetes MCP 服务器（如果您已安装 npm）
npx kubernetes-mcp-server@latest --help

# 使用最新版本二进制文件运行 Kubernetes MCP 服务器
./kubernetes-mcp-server --help

配置选项

选项	描述
--sse-port	以服务器发送事件 (SSE) 模式启动 MCP 服务器，并在指定的端口上侦听。
--log-level	设置日志记录级别（从 0-9 的值）。 类似于 kubectl 日志记录级别。

🧑‍💻 开发 <a id="development"></a>

使用 mcp-inspector 运行

编译项目并使用 mcp-inspector 运行 Kubernetes MCP 服务器以检查 MCP 服务器。

# 编译项目
make build
# 使用 mcp-inspector 运行 Kubernetes MCP 服务器
npx @modelcontextprotocol/inspector@latest $(pwd)/kubernetes-mcp-server