Helm MCP
Give your AI assistant access to real Helm chart data. No more hallucinated values.yaml files.
Open source Repository Open in the app JSON README (API)
About
Give your AI assistant access to real Helm chart data. No more hallucinated values.yaml files.
Details
- Kind
- MCP servers
- Topic
- Cloud & DevOps
- Publisher
- kubedoll-heavy-industries
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 0.1.4
- Open pull requests
- 13
- Last push
- 2026-08-24T03:22:12Z
- Repository state
- ativo
- Language
- Go
- License
- MIT
- Added
- 2026-08-29 03:02:01
- Updated
- 2026-08-29 03:02:01
- Origin id
io.github.Kubedoll-Heavy-Industries/helm-mcp
README
# mcp-helm
[](https://github.com/kubedoll-heavy-industries/helm-mcp/actions/workflows/ci.yml)
[](https://codecov.io/gh/kubedoll-heavy-industries/helm-mcp)
[](https://goreportcard.com/report/github.com/kubedoll-heavy-industries/helm-mcp)
[](https://github.com/kubedoll-heavy-industries/helm-mcp/releases/latest)
[](LICENSE)
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)](https://modelcontextprotocol.io/) — 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
<details>
<summary>Claude Code</summary>
Edit `~/.claude/mcp.json`:
```json
{
"mcpServers": {
"helm": {
"command": "docker",
"args": ["run", "--rm", "-i", "ghcr.io/kubedoll-heavy-industries/mcp-helm", "--transport=stdio"]
}
}
}
```
</details>
<details>
<summary>Claude Desktop</summary>
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"]
}
}
}
```
</details>
<details>
<summary>Cursor</summary>
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"]
}
}
}
```
</details>
<details>
<summary>VS Code + Continue</summary>
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"]
}
}
]
}
}
```
</details>
<details>
<summary>Without Docker</summary>
If you prefer to run the binary directly, [install mcp-helm](#install) and replace the Docker config with:
```json
{
"mcpServers": {
"helm": {
"command": "mcp-helm"
}
}
}
```
</details>
## 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](docs/self-hosting.md) for health endpoints and production recommendations.
## Documentation
- [Configuration Reference](docs/configuration.md) — CLI flags, env vars, transport modes
- [Self-Hosting Guide](docs/self-hosting.md) — Docker HTTP, health endpoints, production tips
- [Troubleshooting](docs/troubleshooting.md) — common issues and fixes
- [Contributing](docs/contributing.md) — development setup, testing, PR guidelines
- [Security Policy](SECURITY.md) — reporting vulnerabilities
## License
MIT — see [LICENSE](LICENSE).