返回 MCP 目录
public公开dns本地运行

manusa_kubernetes-mcp-server

Kubernetes MCP服务器是一个强大的Kubernetes模型上下文协议(MCP)服务实现,支持OpenShift,提供Kubernetes资源操作、Pod管理、事件查看等功能,可与Claude Desktop和Goose CLI集成。

article

README

🚀 Kubernetes MCP 服务器

Kubernetes MCP 服务器是一个强大且灵活的工具,它基于 Kubernetes 模型上下文协议(MCP)实现,支持 OpenShift。能自动检测配置变化,对各类 Kubernetes 资源执行操作,助力高效管理集群。

🚀 快速开始

使用 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 是开启人工智能代理使用的便捷(且经济)方式。

使用 npm

若你已安装 npm,这是使用 kubernetes-mcp-server 的快速途径。 打开你的 goose config.yaml,将 MCP 服务器添加到 mcpServers 列表中:

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

✨ 主要特性

本项目是一个强大且灵活的 Kubernetes 模型上下文协议 (MCP) 服务器实现,支持 OpenShift,具备以下特性:

  • ✅ 配置
    • 自动检测 Kubernetes 配置的变化并更新 MCP 服务器。
    • 查看和管理当前的 Kubernetes .kube/config 或集群内配置。
  • ✅ 常规 Kubernetes 资源:可对任何 Kubernetes 资源执行操作,支持任意 CRUD 操作(创建或更新、获取、列出、删除)。
  • ✅ Pods:能执行特定于 Pod 的操作,如在所有命名空间或特定命名空间中列出 pods;从指定的命名空间中通过名称获取一个 pod;从指定的命名空间中通过名称删除一个 pod;对指定的 pod 显示日志(根据名称);运行一个容器镜像并在 pod 中可选地暴露它。
  • ✅ Events:可查看 Kubernetes 事件,支持在所有命名空间或特定命名空间中查看。

🎥 演示

调 diagnose 和自动修复 OpenShift Deployment

此演示展示了 Kubernetes MCP 服务器如何被 Claude Desktop 利用,以自动诊断和修复 OpenShift 中的部署,无需任何用户干预。 点击查看演示

⚙️ 配置

Kubernetes MCP 服务器可以通过命令行(CLI)进行配置。

启动 MCP 服务器

npx kubernetes-mcp-server@latest

示例用法

npx kubernetes-mcp-server@latest --port 3000

📚 详细文档

API 文档

API Documentation

🧑‍💻 开发

开始使用

npm install -g kubernetes-mcp-server
kubernetes-mcp-server --version

构建项目

git clone https://github.com/YOUR_REPO.git
cd YOUR_REPO
npm install

📄 许可证

GitHub License

👨‍👩‍👧‍👦 社区与支持

加入我们的 Discord 社区 或在 GitHub 上提出问题。

感谢使用 Kubernetes MCP 服务器!

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端