Helm MCP

mcp-helm

让 AI 助手访问真实的 Helm chart 数据。不再生成虚构的 values.yaml 文件。

这是什么？

当你请 Claude、Cursor 或其他 AI 助手帮忙部署 Kubernetes 时，它们无法访问 Helm chart 架构。因此只能猜测——猜出的内容看似合理，实际上却与真实情况不符。

不使用 mcp-helm：

• :x: 虚构看似正确、实际并不存在的字段名
• :x: 推荐过时或已弃用的 chart 版本
• :x: 浪费 token 获取网页内容和猜测

使用 mcp-helm：

• :white_check_mark: 查询真实 Helm 仓库，获取实际 chart 数据
• :white_check_mark: 自动获取最新 chart 版本
• :white_check_mark: 一次就获得正确配置

mcp-helm 实现了 Model Context Protocol (MCP)——这是让 AI 助手访问外部数据源的一种标准方式。

立即试用

将以下内容添加到编辑器的 MCP 配置中，即可使用我们的公共实例（有速率限制，无需安装）：

{
  "mcpServers": {
    "helm": {
      "type": "http",
      "url": "https://helm-mcp.kubedoll.com/mcp"
    }
  }
}

然后询问你的 AI：“bitnami/postgresql chart 可以配置哪些值？”

编辑器设置

{
  "mcpServers": {
    "helm": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/kubedoll-heavy-industries/mcp-helm", "--transport=stdio"]
    }
  }
}

{
  "mcpServers": {
    "helm": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/kubedoll-heavy-industries/mcp-helm", "--transport=stdio"]
    }
  }
}

{
  "mcpServers": {
    "helm": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/kubedoll-heavy-industries/mcp-helm", "--transport=stdio"]
    }
  }
}

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "docker",
          "args": ["run", "--rm", "-i", "ghcr.io/kubedoll-heavy-industries/mcp-helm", "--transport=stdio"]
        }
      }
    ]
  }
}

{
  "mcpServers": {
    "helm": {
      "command": "mcp-helm"
    }
  }
}

可用工具

OCI 注册表（oci://...）不支持浏览——使用 OCI 时，你必须事先知道 chart 名称，然后直接使用该名称调用 get_versions 或 get_values。

安装

Docker（推荐——无需安装，以上“编辑器设置”中也使用此方式）：

docker pull ghcr.io/kubedoll-heavy-industries/mcp-helm:latest

二进制文件：

curl -fsSL https://github.com/kubedoll-heavy-industries/helm-mcp/releases/latest/download/mcp-helm_$(uname -s)_$(uname -m).tar.gz | tar xz
sudo mv mcp-helm /usr/local/bin/

Go：

go install github.com/kubedoll-heavy-industries/helm-mcp/cmd/mcp-helm@latest

自托管

用于共享部署或需要 HTTP 端点的场景：

docker run -p 8012:8012 ghcr.io/kubedoll-heavy-industries/mcp-helm:latest \
  --transport=http --listen=:8012
# Connect to http://localhost:8012/mcp

有关健康检查端点和生产环境建议，请参阅 docs/self-hosting.md。

文档

• 配置参考 — CLI 标志、环境变量、传输模式
• 自托管指南 — Docker HTTP、健康检查端点、生产环境建议
• 故障排除 — 常见问题及解决方法
• 贡献指南 — 开发环境设置、测试、PR 指南
• 安全政策 — 漏洞报告方式

许可证

MIT — 参见 LICENSE。