Helm MCP

Official5 toolsLive

by kubedoll-heavy-industries · Go

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

io.github.Kubedoll-Heavy-Industries/helm-mcp — Model Context Protocol (MCP) Server

This MCP server provides AI assistants access to real Helm chart data, avoiding hallucinated values.yaml content. The repository targets Helm and Kubernetes workflows and is labeled as an MCP server for use with the Model Context Protocol.

🛠️ Key Features

Access to real Helm chart data
Tool set count: 5

🚀 Use Cases

Retrieving Helm chart information from Kubernetes-focused contexts
Using real values.yaml-related data instead of generated guesses

⚡ Developer Benefits

Grounded Helm data retrieval for AI assistants
Topics include helm, kubernetes, mcp, and model-context-protocol

⚠️ Limitations

Limited details provided here beyond Helm chart access and the existence of 5 tools

Metadata

Topics: helm, kubernetes, llm, mcp, mcp-server, model-context-protocol, oci
Repo: io.github.Kubedoll-Heavy-Industries/helm-mcp

Topics

helmkubernetesllmmcpmcp-servermodel-context-protocoloci

Captured live from the server via tools/list.

get_dependencies

Get chart dependencies (sub-charts). Each dependency entry includes the dependency's repository URL — feed that URL back into search_charts, get_versions, or get_values to inspect the dependency. Supports both HTTP/HTTPS repos and OCI registries (oci://).

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "repository_url": {
      "type": "string",
      "description": "Helm repository URL (e.g. https://charts.bitnami.com/bitnami) or OCI registry (e.g. oci://ghcr.io/traefik/helm)"
    },
    "chart_name": {
      "type": "string",
      "description": "Chart name (e.g. postgresql)"
    },
    "chart_version": {
      "type": "string",
      "description": "Chart version (defaults to latest)"
    }
  },
  "required": [
    "repository_url",
    "chart_name"
  ],
  "additionalProperties": false
}

get_notes

Get chart NOTES.txt (post-install instructions). Supports both HTTP/HTTPS repos and OCI registries (oci://).

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "repository_url": {
      "type": "string",
      "description": "Helm repository URL (e.g. https://charts.bitnami.com/bitnami) or OCI registry (e.g. oci://ghcr.io/traefik/helm)"
    },
    "chart_name": {
      "type": "string",
      "description": "Chart name (e.g. postgresql)"
    },
    "chart_version": {
      "type": "string",
      "description": "Chart version (defaults to latest)"
    }
  },
  "required": [
    "repository_url",
    "chart_name"
  ],
  "additionalProperties": false
}

get_values

Get chart values.yaml with optional JSON schema. Uses depth limiting (default 2) to show structure without overwhelming context. Use path to drill into specific sections, depth=0 for full YAML. include_examples surfaces nearby commented YAML examples and requires path to be set. Supports both HTTP/HTTPS repos and OCI registries (oci://).

Parameters11

repository_url	string	required	Helm repository URL (e.g. https://charts.bitnami.com/bitnami) or OCI registry (e.g. oci://ghcr.io/traefik/helm)
chart_name	string	required	Chart name (e.g. postgresql)
chart_version	string	optional	Chart version (defaults to latest)
path	string	optional	YAML path (e.g. .ingress.enabled)
depth	null \| integer	optional	Max nesting depth (default 2, 0 for unlimited)
max_array_items	null \| integer	optional	Max array items before truncation (default 3, 0 for unlimited)
show_comments	null \| boolean	optional	Preserve YAML comments
show_defaults	null \| boolean	optional	Include default values
include_schema	null \| boolean	optional	Include values.schema.json in response
include_examples	null \| boolean	optional	Include nearby commented YAML examples for the selected path (requires path to be set)
example_limit	null \| integer	optional	Maximum nearby examples to include (default 1, max 3, 0 falls back to default)

Raw schema

{
  "type": "object",
  "properties": {
    "repository_url": {
      "type": "string",
      "description": "Helm repository URL (e.g. https://charts.bitnami.com/bitnami) or OCI registry (e.g. oci://ghcr.io/traefik/helm)"
    },
    "chart_name": {
      "type": "string",
      "description": "Chart name (e.g. postgresql)"
    },
    "chart_version": {
      "type": "string",
      "description": "Chart version (defaults to latest)"
    },
    "path": {
      "type": "string",
      "description": "YAML path (e.g. .ingress.enabled)"
    },
    "depth": {
      "type": [
        "null",
        "integer"
      ],
      "description": "Max nesting depth (default 2, 0 for unlimited)"
    },
    "max_array_items": {
      "type": [
        "null",
        "integer"
      ],
      "description": "Max array items before truncation (default 3, 0 for unlimited)"
    },
    "show_comments": {
      "type": [
        "null",
        "boolean"
      ],
      "description": "Preserve YAML comments"
    },
    "show_defaults": {
      "type": [
        "null",
        "boolean"
      ],
      "description": "Include default values"
    },
    "include_schema": {
      "type": [
        "null",
        "boolean"
      ],
      "description": "Include values.schema.json in response"
    },
    "include_examples": {
      "type": [
        "null",
        "boolean"
      ],
      "description": "Include nearby commented YAML examples for the selected path (requires path to be set)"
    },
    "example_limit": {
      "type": [
        "null",
        "integer"
      ],
      "description": "Maximum nearby examples to include (default 1, max 3, 0 falls back to default)"
    }
  },
  "required": [
    "repository_url",
    "chart_name"
  ],
  "additionalProperties": false
}

get_versions

Get available versions of a chart (newest first). Supports both HTTP/HTTPS repos and OCI registries (oci://). Use this to confirm a chart exists before calling get_values, or to find a specific version to pin.

Parameters3

repository_url	string	required	Helm repository URL (e.g. https://charts.bitnami.com/bitnami) or OCI registry (e.g. oci://ghcr.io/traefik/helm)
chart_name	string	required	Chart name (e.g. postgresql)
limit	integer	optional	Maximum results (default 20, max 100)

Raw schema

{
  "type": "object",
  "properties": {
    "repository_url": {
      "type": "string",
      "description": "Helm repository URL (e.g. https://charts.bitnami.com/bitnami) or OCI registry (e.g. oci://ghcr.io/traefik/helm)"
    },
    "chart_name": {
      "type": "string",
      "description": "Chart name (e.g. postgresql)"
    },
    "limit": {
      "type": "integer",
      "description": "Maximum results (default 20, max 100)"
    }
  },
  "required": [
    "repository_url",
    "chart_name"
  ],
  "additionalProperties": false
}

search_charts

List or search charts in a Helm repository. Provide a repository_url, then optionally filter by keyword (e.g. keyword='postgres'). Note: 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.

Parameters3

repository_url	string	required	Helm repository URL (e.g. https://charts.bitnami.com/bitnami) or OCI registry (e.g. oci://ghcr.io/traefik/helm)
keyword	string	optional	Filter charts by name (case-insensitive substring match, e.g. 'postgres')
limit	integer	optional	Maximum results (default 50, max 200)

Raw schema

{
  "type": "object",
  "properties": {
    "repository_url": {
      "type": "string",
      "description": "Helm repository URL (e.g. https://charts.bitnami.com/bitnami) or OCI registry (e.g. oci://ghcr.io/traefik/helm)"
    },
    "keyword": {
      "type": "string",
      "description": "Filter charts by name (case-insensitive substring match, e.g. 'postgres')"
    },
    "limit": {
      "type": "integer",
      "description": "Maximum results (default 50, max 200)"
    }
  },
  "required": [
    "repository_url"
  ],
  "additionalProperties": false
}

README.md6 KBView on GitHub

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:

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

With mcp-helm:

✅ Queries actual Helm repositories for real chart data
✅ Gets the latest chart version automatically
✅ 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):

json

{
  "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:

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):

json

{
  "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:

json

{
  "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):

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:

json

{
  "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):

bash

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

Binary:

bash

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:

bash

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:

bash

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.

Install

Tools (5)

get_dependenciesget_notesget_valuesget_versionssearch_charts

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

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

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "helm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://helm-mcp.kubedoll.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.Kubedoll-Heavy-Industries/helm-mcp — Model Context Protocol (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Metadata

Topics

get_dependencies

get_notes

get_values

get_versions

search_charts

mcp-helm

What is this?

Try It Now

Editor Setup

Available Tools

Install

Self-Hosting

Documentation

License

Install

Remote endpoint

Related servers