Add Helm(CLI) MCP Server Implementation

[jeff-nasseri]

Helm(CLI) MCP Server

This PR adds a Helm MCP server that allows AI Assistants to interact with Helm, the Kubernetes package manager.

Overview

The Helm MCP server provides a bridge between AI assistants and the Helm CLI, enabling natural language execution of Helm commands for managing Kubernetes applications. This server supports all major Helm commands, allowing assistants to help users install, upgrade, and manage charts and releases.

Supported Commands

The server implements the following Helm commands:

Completion Commands

• helm completion - Generate autocompletion scripts for bash, fish, powershell, and zsh

Chart Creation and Management

• helm create - Create a new chart
• helm lint - Verify chart formatting
• helm package - Package a chart directory into a chart archive
• helm template - Render chart templates locally

Dependency Management

• helm dependency build - Build chart dependencies
• helm dependency list - List chart dependencies
• helm dependency update - Update chart dependencies

Environment

• helm env - Show Helm environment information
• helm version - Show Helm version

Release Management

• helm install - Install a chart
• helm uninstall - Uninstall a release
• helm upgrade - Upgrade a release
• helm rollback - Rollback a release to a previous revision
• helm list - List releases
• helm status - Show release status
• helm history - Show release history
• helm test - Run tests for a release

Release Information

• helm get all - Get all information about a release
• helm get hooks - Get hooks for a release
• helm get manifest - Get manifest for a release
• helm get metadata - Get metadata for a release
• helm get notes - Get notes for a release
• helm get values - Get values for a release

Repository Management

• helm repo add - Add a chart repository
• helm repo index - Generate an index file for a chart repository
• helm repo list - List chart repositories
• helm repo remove - Remove a chart repository
• helm repo update - Update chart repositories
• helm search repo - Search repositories for charts
• helm search hub - Search Helm Hub for charts

Registry Management

• helm registry login - Log in to a registry
• helm registry logout - Log out from a registry
• helm push - Push a chart to a registry
• helm pull - Pull a chart from a repository

Chart Information

• helm show all - Show all information for a chart
• helm show chart - Show chart definition
• helm show crds - Show Custom Resource Definitions
• helm show readme - Show README
• helm show values - Show values

Plugin Management

• helm plugin install - Install a plugin
• helm plugin list - List plugins
• helm plugin uninstall - Uninstall a plugin
• helm plugin update - Update a plugin

Verification

• helm verify - Verify a chart

Example Usage

# List Helm repositories
client.call_tool("helm_repo_list", {})

# Install a chart
client.call_tool("helm_install", {
  "chart": "bitnami/nginx",
  "release_name": "my-nginx",
  "namespace": "default",
  "set_values": {
    "replicaCount": "3",
    "service.type": "ClusterIP"
  }
})

# Search for charts
client.call_tool("helm_search_repo", {"keyword": "prometheus"})

Test Plan

• Manual testing with MCP Inspector
• Verified all commands work with appropriate parameters
• Tested with real Kubernetes clusters
• Verified chart installation, upgrade, and uninstallation
• Tested repository management workflows

Inspector

To run the mcp with inspector you can run the following command

npx @modelcontextprotocol/inspector uvx mcp-server-helm

Make sure you've already installed Helm on your system and it's connected to a cluster. You can try minikube

Claude Desktop

mcp-helm-claude-desktop.mp4

Inspector

mcp-helm-inspector.mp4

Related Issue: #1606

[jeff-nasseri]

Here is the listed at MCP.so marketplace:
https://mcp.so/server/helm-cli/Jeff%20Nasseri

[jeff-nasseri]

Actual source code moved to https://github.com/jeff-nasseri/helm-chart-cli-mcp

[jeff-nasseri]

@evalstate, could you please follow up this pull request and let me know what needs to be done in order to merge the pull request? otherwise if everything is ok, perhaps we can merge this. Thanks in advance.

[evalstate]

Sorry to be a pain, if you can make it alphabetical and commit I should be able to merge directly.

[jeff-nasseri]

Sorry to be a pain, if you can make it alphabetical and commit I should be able to merge directly.

Here is the commit for making this alphabetical, please let me know if I need to do anything else. Thanks again.

7e5dd99
@evalstate
@Kamyab7