Kubernetes MCP Server

✨ 功能特性 | 🚀 快速开始 | 🎥 演示 | ⚙️ 配置 | 🛠️ 工具 | 💬 社区 | 🧑‍💻 开发

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

✨ 功能特性

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

• ✅ 配置：
  • 自动检测 Kubernetes 配置的变更并更新 MCP 服务器。
  • 查看和管理当前的 Kubernetes .kube/config 或集群内配置。
• ✅ 通用 Kubernetes 资源：对任何 Kubernetes 或 OpenShift 资源执行操作。
  • 任意 CRUD 操作（创建或更新、获取、列出、删除）。
• ✅ Pod：执行 Pod 特有的操作。
  • 列出所有命名空间或指定命名空间中的 Pod。
  • 从指定命名空间获取指定名称的 Pod。
  • 从指定命名空间删除指定名称的 Pod。
  • 从指定命名空间显示指定名称 Pod 的日志。
  • Top 获取指定命名空间中所有 Pod 或特定 Pod 的资源使用指标。
  • Exec 进入 Pod 并运行命令。
  • 运行 Pod 中的容器镜像，并可选择将其暴露。
• ✅ 命名空间：列出 Kubernetes 命名空间。
• ✅ 事件：查看所有命名空间或指定命名空间中的 Kubernetes 事件。
• ✅ 项目：列出 OpenShift 项目。
• ☸️ Helm：
  • 在当前或提供的命名空间中安装 Helm chart。
  • 列出所有命名空间或指定命名空间中的 Helm release。
  • 在当前或提供的命名空间中卸载 Helm release。
• 🔧 Tekton：Tekton 特有的操作，补充通用 Kubernetes 资源管理。
  • Pipeline：通过创建 PipelineRun 启动 Tekton Pipeline。
  • PipelineRun：重启、取消、故障排查并获取 PipelineRun 日志。
  • Task：通过创建 TaskRun 启动 Tekton Task。
  • TaskRun：使用相同的 spec 重启 TaskRun，并通过 Pod 解析获取 TaskRun 日志。
• 🔭 可观测性：可选的 OpenTelemetry 分布式追踪和指标，支持自定义采样率。包含用于实时统计的 /stats 端点。参见 OTEL.md。

与其他 Kubernetes MCP 服务器实现不同，这不是仅仅对 kubectl 或 helm 命令行工具的封装。它是一个基于 Go 的原生实现，直接与 Kubernetes API 服务器交互。

系统上无需安装外部依赖或工具。如果你使用原生二进制文件，则无需在系统上安装 Node 或 Python。

• ✅ 轻量级：服务器以单个原生二进制文件形式分发，支持 Linux、macOS 和 Windows。
• ✅ 高性能 / 低延迟：直接与 Kubernetes API 服务器交互，无需调用和等待外部命令的开销。
• ✅ 多集群：可以同时与多个 Kubernetes 集群交互（如 kubeconfig 文件中定义的那样）。
• ✅ 跨平台：可作为 Linux、macOS 和 Windows 的原生二进制文件，也可作为 npm 包、Python 包以及容器/Docker 镜像使用。
• ✅ 可配置：支持命令行参数、TOML 配置文件和环境变量。
• ✅ 测试完善：服务器拥有广泛的测试套件，以确保其在不同的 Kubernetes 环境中的可靠性和正确性。
• 📚 文档：全面的用户文档，包括设置指南、配置参考和可观测性。

🚀 快速开始

要求

• 访问 Kubernetes 集群的权限。

Claude Code

请参阅我们用户文档中的专用 Claude Code 快速入门指南。

有关安全的生产环境设置…