MCP Helm

🚀 MCP Helm Server

An MCP (Model Context Protocol) server offering tools to interact with Helm repositories and charts. It allows AI assistants to query Helm repositories, retrieve chart information, and access chart values without local Helm installation.

🚀 Quick Start

The MCP Helm server is designed to facilitate interactions with Helm repositories and charts. By using MCP for Helm, it avoids fabricating the format of values.yaml and chart contents when working with LLMs. Instead, it offers a standardized approach for accessing this information, making it more convenient for AI assistants to interact with Helm charts and repositories. Note that this MCP server is and will be focused on providing tools for Helm repositories only. For other Kubernetes resources, consider using a separate MCP server.

✨ Features

The MCP Helm server provides the following tools:

• list_repository_charts - Lists all charts available in a Helm repository
• get_latest_version_of_chart - Retrieves the latest version of a specific chart
• get_chart_values - Retrieves the values file for a chart (latest version or specific version)
• get_chart_contents - Retrieves the contents of a chart (including templates, values, and metadata).
• get_chart_dependencies - Retrieves the dependencies of a chart as defined in its Chart.yaml file.

🚀 Try without installation

There is a publicly available instance of the MCP Helm server that you can use to test the features without installing it: https://mcp-helm.zekker.dev/sse

📦 Installation

Run with docker

You can run the MCP Helm server using Docker. This is the easiest way to get started without needing to install Go or build from source.

docker run -d --name mcp-helm -p 8012:8012 --command ghcr.io/zekker6/mcp-helm:v0.0.5 -mode=sse

Note that the --mode=sse flag is used to enable Server-Sent Events mode, which used by MCP clients to connect. Alternatively, you can use -mode=http to enable Streamable HTTP mode.

Via pre-build binary

Download binary from the releases page. Example for Linux x86_64 (note that other architectures and platforms are also available):

latest=$(curl -s https://api.github.com/repos/zekker6/mcp-helm/releases/latest | grep 'tag_name' | cut -d\" -f4)
wget https://github.com/zekker6/mcp-helm/releases/download/$latest/mcp-helm_Linux_x86_64.tar.gz
tar axvf mcp-helm_Linux_x86_64.tar.gz

Via Mise

Mise (mise-en-place) is a development environment setup tool.

mise i ubi:zekker6/mcp-helm@latest

Install with Go

⚠️ Important Note

Go 1.24.3 is required.

go install github.com/zekker6/mcp-helm/cmd/mcp-helm@latest

Build from Source

⚠️ Important Note

Go 1.24.3 is required.

1. Clone the repository:

   git clone https://github.com/zekker6/mcp-helm.git
   cd mcp-helm
   

2. Build the binary:

   go build -o mcp-helm ./cmd/mcp-helm
   

3. Run the server:

   ./mcp-helm
   

📚 Documentation

Configure your MCP client to connect to this server. The server implements the standard MCP protocol for tool discovery and execution.

🔧 Roadmap

• [ ] Add more tools
  • [x] List all charts in a repository
  • [x] Get latest version of the chart
  • [x] Get values for chart
  • [x] Get values for the latest version of the chart
  • [x] Extract full chart content
  • [x] Extract dependant charts from Charts.yaml
  • [ ] Extract images used in chart
• [ ] Support using private registries
  • [ ] Add a way to provide credentials