Kubernetes MCP 服务器

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

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

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

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

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

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

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"
      ]
    }
  }
}

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

⚙️ 配置 <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 服务器，并在指定的端口上侦听。

🧑‍💻 开发 <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