Helm MCP
Give your AI assistant access to real Helm chart data. No more hallucinated values.yaml files.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"helm-mcp": {
"url": "https://helm-mcp.kubedoll.com/mcp"
}
}
}Puntos de conexión remotos
https://helm-mcp.kubedoll.com/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (5)
🟢get_dependencies(repository_url, chart_name, chart_version)
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://).
Esquema de entrada
{
"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
}Esquema de salida
{
"type": "object",
"properties": {
"version": {
"type": "string",
"description": "Resolved chart version (especially useful when chart_version was omitted and latest was used)"
},
"dependencies": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Dependency name"
},
"version": {
"type": "string",
"description": "Version constraint"
},
"repository": {
"type": "string",
"description": "Repository URL (empty for bundled)"
},
"condition": {
"type": "string",
"description": "Condition for enabling"
},
"alias": {
"type": "string",
"description": "Alias name"
}
},
"required": [
"name",
"version"
],
"additionalProperties": false
},
"description": "Chart dependencies"
}
},
"required": [
"version",
"dependencies"
],
"additionalProperties": false
}🟢get_notes(repository_url, chart_name, chart_version)
Get chart NOTES.txt (post-install instructions). Supports both HTTP/HTTPS repos and OCI registries (oci://).
Esquema de entrada
{
"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
}Esquema de salida
{
"type": "object",
"properties": {
"version": {
"type": "string",
"description": "Resolved chart version (especially useful when chart_version was omitted and latest was used)"
},
"notes": {
"type": "string",
"description": "Contents of NOTES.txt"
}
},
"required": [
"version",
"notes"
],
"additionalProperties": false
}🟢get_values(repository_url, chart_name, chart_version, path, depth, ...)
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://).
Esquema de entrada
{
"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
}Esquema de salida
{
"type": "object",
"properties": {
"version": {
"type": "string",
"description": "Resolved chart version (especially useful when chart_version was omitted and latest was used)"
},
"values": {
"type": "string",
"description": "Values content (YAML)"
},
"path": {
"type": "string",
"description": "Extracted path, if specified"
},
"schema": {
"type": "string",
"description": "JSON Schema for values (if include_schema=true and schema exists)"
},
"schema_warning": {
"type": "string",
"description": "Set when include_schema=true but the schema could not be retrieved; absence of this field with empty schema means the chart has no schema"
},
"parse_warning": {
"type": "string",
"description": "Set when the YAML parser failed on this chart's values.yaml. The 'values' field then contains raw bytes (possibly truncated) and path/depth/include_examples/include_schema were not applied"
},
"examples": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"yaml": {
"type": "string",
"description": "Example YAML"
},
"source": {
"type": "string",
"description": "Where the example was found"
},
"confidence": {
"type": "string",
"description": "Confidence that the commented block is a usable example"
}
},
"required": [
"yaml",
"source",
"confidence"
],
"additionalProperties": false
},
"description": "Nearby commented YAML examples, if include_examples=true and examples are found"
}
},
"required": [
"version",
"values"
],
"additionalProperties": false
}🟢get_versions(repository_url, chart_name, limit)
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.
Esquema de entrada
{
"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
}Esquema de salida
{
"type": "object",
"properties": {
"versions": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"version": {
"type": "string",
"description": "Chart version"
},
"app_version": {
"type": "string",
"description": "Application version"
},
"created": {
"type": "string",
"description": "Creation timestamp (RFC3339)"
},
"deprecated": {
"type": "boolean",
"description": "Whether the version is deprecated"
}
},
"required": [
"version",
"deprecated"
],
"additionalProperties": false
},
"description": "Chart versions (newest first)"
},
"total": {
"type": "integer",
"description": "Total versions available (may exceed returned results if limit applied)"
}
},
"required": [
"versions",
"total"
],
"additionalProperties": false
}🟢search_charts(repository_url, keyword, limit)
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.
Esquema de entrada
{
"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
}Esquema de salida
{
"type": "object",
"properties": {
"charts": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
},
"description": "Chart names"
},
"total": {
"type": "integer",
"description": "Total matching charts (may exceed returned results if limit applied)"
}
},
"required": [
"charts",
"total"
],
"additionalProperties": false
}Comunidad
Evidencia