https://github.com/zekker6/mcp-helm
MCP server for Helm package manager
https://github.com/zekker6/mcp-helm
helm kubernetes mcp
Last synced: 3 months ago
JSON representation
MCP server for Helm package manager
- Host: GitHub
- URL: https://github.com/zekker6/mcp-helm
- Owner: zekker6
- License: mit
- Created: 2025-06-01T10:02:11.000Z (4 months ago)
- Default Branch: master
- Last Pushed: 2025-06-19T09:05:56.000Z (4 months ago)
- Last Synced: 2025-06-19T10:25:04.955Z (4 months ago)
- Topics: helm, kubernetes, mcp
- Language: Go
- Homepage:
- Size: 95.7 KB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **mcp-helm** - MCP server for Helm package manager `go` `helm` `kubernetes` `mcp` `server` `go install zekker6/mcp-helm@latest` (DevOps)
- awesome-mcp-servers - **mcp-helm** - MCP server for Helm package manager `go` `helm` `kubernetes` `mcp` `server` `go install zekker6/mcp-helm@latest` (DevOps)
README
# MCP Helm Server
An MCP (Model Context Protocol) server that provides tools for interacting with Helm repositories and charts. This
server enables AI assistants to query Helm repositories, retrieve chart information, and access chart values without
requiring local Helm installation.
The purpose of using MCP for Helm is to avoid making up format of `values.yaml` and contents of the charts when working
with LLMs.
Instead, the server provides a standardized way to access this information, making it easier for AI assistants to
interact with Helm charts and repositories.
This MCP server is and will be providing tools for working with Helm repositories only. If you need to work with other
Kubernetes resources, consider using a separate MCP server that provides tools for Kubernetes resources.
## 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.
```bash
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](https://github.com/zekker6/mcp-helm/releases).
Example for Linux x86_64 (note that other architectures and platforms are also available):
```bash
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](https://mise.jdx.dev/)) is a development environment setup tool.
```bash
mise i ubi:zekker6/mcp-helm@latest
```
### Install with Go
> Note: Go 1.24.3 is required.
```bash
go install github.com/zekker6/mcp-helm/cmd/mcp-helm@latest
```
### Build from Source
> Note: Go 1.24.3 is required.
1. Clone the repository:
```bash
git clone https://github.com/zekker6/mcp-helm.git
cd mcp-helm
```
2. Build the binary:
```bash
go build -o mcp-helm ./cmd/mcp-helm
```
3. Run the server:
```bash
./mcp-helm
```
## Configuration
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