kubernetes-mcp-server

by manusa
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Allows viewing and managing Kubernetes resources including configuration, generic resources, and pods. Supports operations like CRUD on any Kubernetes resource, listing/getting/deleting pods, showing pod logs, and running container images.

Kubernetes MCP 服务器

✨ 功能| 🚀 入门| 🎥 演示| ⚙️ 配置| 🧑‍💻 开发

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

✨ 特点

强大而灵活的 Kubernetes模型上下文协议 (MCP)服务器实现,支持KubernetesOpenShift

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

与其他 Kubernetes MCP 服务器实现不同,这不仅仅是kubectlhelm命令行工具的包装器。

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

🚀 入门

要求

  • 访问 Kubernetes 集群。

克劳德桌面

使用 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 内部人士

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

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

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

Goose 命令行界面

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

使用 npm

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

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

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

🎥 演示

诊断并自动修复 OpenShift 部署

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

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

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

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

⚙️ 配置

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

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

# Run the Kubernetes MCP server using npx (in case you have npm installed) npx kubernetes-mcp-server@latest --help
# Run the Kubernetes MCP server using the latest release binary ./kubernetes-mcp-server --help

配置选项

选项描述
--sse-port以服务器发送事件 (SSE) 模式启动 MCP 服务器并监听指定端口。
--log-level设置日志级别(值从 0 到 9 )。类似于kubectl logging levels

🧑‍💻开发

使用 mcp-inspector 运行

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

# Compile the project make build # Run the Kubernetes MCP server with mcp-inspector npx @modelcontextprotocol/inspector@latest $(pwd)/kubernetes-mcp-server
ID: 7teahc9mqv