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

mcp-helm

MCP Helm Server是一个提供与Helm仓库和图表交互工具的服务,使AI助手无需本地安装Helm即可查询仓库、获取图表信息和值文件。

article

README

🚀 MCP Helm 服务器

MCP(模型上下文协议)服务器为与 Helm 仓库和图表进行交互提供了工具。借助该服务器,AI 助手无需在本地安装 Helm,即可查询 Helm 仓库、获取图表信息并访问图表值。

使用 MCP 处理 Helm 的目的在于,避免在与大语言模型(LLMs)协作时,自行编造 values.yaml 的格式和图表内容。相反,服务器提供了一种标准化的方式来访问这些信息,使 AI 助手能更便捷地与 Helm 图表和仓库进行交互。

此 MCP 服务器目前仅提供处理 Helm 仓库的工具,未来也将如此。若你需要处理其他 Kubernetes 资源,可考虑使用专门为 Kubernetes 资源提供工具的 MCP 服务器。

✨ 主要特性

MCP Helm 服务器提供了以下工具:

  • list_repository_charts - 列出 Helm 仓库中所有可用的图表
  • get_latest_version_of_chart - 获取特定图表的最新版本
  • get_chart_values - 获取图表的值文件(最新版本或特定版本)
  • get_chart_contents - 获取图表的内容(包括模板、值和元数据)
  • get_chart_dependencies - 根据 Chart.yaml 文件获取图表的依赖项

🚀 快速开始

免安装试用

有一个公开可用的 MCP Helm 服务器实例,你可以在不安装的情况下测试其功能:https://mcp-helm.zekker.dev/sse

📦 安装指南

使用 Docker 运行

你可以使用 Docker 运行 MCP Helm 服务器。这是一种无需安装 Go 或从源代码构建即可快速上手的简单方法。

docker run -d --name mcp-helm -p 8012:8012 --command ghcr.io/zekker6/mcp-helm:v0.0.5 -mode=sse

请注意,--mode=sse 标志用于启用服务器发送事件(Server-Sent Events)模式,MCP 客户端使用此模式进行连接。你也可以使用 -mode=http 来启用可流式传输的 HTTP 模式。

通过预构建二进制文件安装

发布页面下载二进制文件。

以下是 Linux x86_64 系统的示例(注意,其他架构和平台也可用):

latest=$(curl -s https://api.github.com/repos/zekker6/mcp-helm/releases/latest | grep 'tag_name' | cut -d\" -f4)
wget https://github.com/zekker6/mcp-helm/releases/download/$latest/mcp-helm_Linux_x86_64.tar.gz
tar axvf mcp-helm_Linux_x86_64.tar.gz

通过 Mise 安装

Mise (mise-en-place) 是一个开发环境设置工具。

mise i ubi:zekker6/mcp-helm@latest

使用 Go 安装

注意:需要 Go 1.24.3 版本。

go install github.com/zekker6/mcp-helm/cmd/mcp-helm@latest

从源代码构建

注意:需要 Go 1.24.3 版本。

  1. 克隆仓库:
git clone https://github.com/zekker6/mcp-helm.git
cd mcp-helm
  1. 构建二进制文件:
go build -o mcp-helm ./cmd/mcp-helm
  1. 运行服务器:
./mcp-helm

📚 详细文档

配置你的 MCP 客户端以连接到该服务器。该服务器实现了用于工具发现和执行的标准 MCP 协议。

🔧 路线图

  • [ ] 添加更多工具
    • [x] 列出仓库中的所有图表
    • [x] 获取图表的最新版本
    • [x] 获取图表的值
    • [x] 获取图表最新版本的值
    • [x] 提取完整的图表内容
    • [x] 从 Charts.yaml 中提取依赖的图表
    • [ ] 提取图表中使用的镜像
  • [ ] 支持使用私有注册表
    • [ ] 添加提供凭证的方式
help

运行方式说明

cloud

托管运行

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

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

本地运行 / 其它方式

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

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