Helm MCP

Name: Helm MCP
Author: Kubedoll-Heavy-Industries

Remote

github.com/Kubedoll-Heavy-IndustriesCloud & Infra0Updated 9w ago

Repository

About Helm MCP

Helm MCP provides AI assistants with chart data from Helm repositories for Kubernetes deployment work. Its tools retrieve chart versions, values, dependencies, and installation notes rather than relying on guessed configuration fields.

Key features

01Search Helm repository charts
02List available chart versions
03Retrieve values.yaml sections and schemas
04Inspect chart dependencies
05Read chart installation notes

Use cases

01Check valid values for a Kubernetes chart
02Find the latest available chart version
03Review chart dependencies before deployment
04Retrieve post-install instructions

MCP support

Exposes Helm chart search and inspection tools to MCP clients. It supports a public HTTP endpoint as well as stdio connections, and can be self-hosted over HTTP.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://helm-mcp.kubedoll.com/mcp

Copy install command

Claude CodeTerminalclaude mcp add --transport http kubedoll-heavy-industries-helm https://helm-mcp.kubedoll.com/mcp

Cursor.cursor/mcp.json{"mcpServers":{"kubedoll-heavy-industries-helm":{"type":"http","url":"https://helm-mcp.kubedoll.com/mcp"}}}Open in Cursor

VS Code.vscode/mcp.json{"servers":{"kubedoll-heavy-industries-helm":{"type":"http","url":"https://helm-mcp.kubedoll.com/mcp"}}}Open in VS Code

Claude Desktopclaude_desktop_config.json{"mcpServers":{"kubedoll-heavy-industries-helm":{"type":"http","url":"https://helm-mcp.kubedoll.com/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"kubedoll-heavy-industries-helm":{"serverUrl":"https://helm-mcp.kubedoll.com/mcp"}}}

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

Tools

Parameter	Type	Required	Description
chart_name	string	Yes	Chart name (e.g. postgresql)
chart_version	string	No	Chart version (defaults to latest)
repository_url	string	Yes	Helm repository URL (e.g. https://charts.bitnami.com/bitnami) or OCI registry (e.g. oci://ghcr.io/traefik/helm)

Details

From the project README

mcp-helm

Give your AI assistant access to real Helm chart data. No more hallucinated values.yaml files.

What is this?

When you ask Claude, Cursor, or other AI assistants to help with Kubernetes deployments, they don't have access to Helm chart schemas. So they guess — and the guesses look plausible but don't match reality.

Without mcp-helm:

:x: Hallucinates field names that look right but don't exist
:x: Suggests stale or deprecated chart versions
:x: Wastes tokens on web fetches and guesswork

With mcp-helm:

:white_check_mark: Queries actual Helm repositories for real chart data
:white_check_mark: Gets the latest chart version automatically
:white_check_mark: Correct configurations the first time

mcp-helm implements the Model Context Protocol (MCP) — a standard way for AI assistants to access external data sources.

Try It Now

Add this to your editor's MCP config to use our public instance (rate limited, no install required):

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

Then ask your AI: "What values can I configure for the bitnami/postgresql chart?"

Editor Setup

Claude Code

Edit ~/.claude/mcp.json:

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

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Cursor

Edit MCP settings in Cursor's configuration:

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

VS Code + Continue

Add to your Continue config (~/.continue/config.json):

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

Without Docker

If you prefer to run the binary directly, install mcp-helm and replace the Docker config with:

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

Available Tools

Tool	What it does	Useful parameters
`search_charts`	List or search charts in a Helm repo	`keyword` (substring filter), `limit`
`get_versions`	Get available versions of a chart (newest first)	`limit=1` for the latest only
`get_values`	Get chart `values.yaml`, optionally as a focused subsection	`path` (e.g. `.ingress`), `depth` (default 2, `0` for full YAML), `include_schema=true`, `include_examples=true` (requires `path`)
`get_dependencies`	Get a chart's sub-charts (with their repo URLs, which can be fed back into the other tools)	—
`get_notes`	Get chart NOTES.txt (post-install instructions)	—

OCI registries (oci://...) do not support browsing — for OCI you must already know the chart name, then call get_versions or get_values directly with that name.

Install

Docker (recommended — no install required, used in Editor Setup above):

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

Binary:

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

Self-Hosting

For shared deployments or when you need an HTTP endpoint:

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

See docs/self-hosting.md for health endpoints and production recommendations.

Documentation

Configuration Reference — CLI flags, env vars, transport modes
Self-Hosting Guide — Docker HTTP, health endpoints, production tips
Troubleshooting — common issues and fixes
Contributing — development setup, testing, PR guidelines
Security Policy — reporting vulnerabilities

License

MIT — see LICENSE.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.