MCP Hangar Helm Charts

Helm charts for deploying the MCP Hangar ecosystem on Kubernetes.

This repository contains official Helm charts for MCP Hangar.

Charts

• mcp-hangar — Core MCP Hangar server
• mcp-hangar-operator — Kubernetes operator for MCP provider lifecycle management

For current chart and appVersion numbers, see the releases page and the compatibility matrix, which are the source of truth for supported combinations and verified digests. See RELEASE.md for how charts are versioned and published.

Prerequisites

• Kubernetes 1.25+
• Helm 3.x

Quick Start

Install the charts directly from the GHCR OCI registry.

# Add namespace
kubectl create namespace mcp-hangar

# Install the core server (latest published chart). For a quick, insecure demo
# opt in with config.unsafeNoAuth=true; the server's fail-closed auth behavior
# is documented in the core README (linked below).
helm install mcp-hangar oci://ghcr.io/mcp-hangar/charts/mcp-hangar \
  --namespace mcp-hangar \
  --set config.unsafeNoAuth=true

# Install the operator (latest published chart)
helm install mcp-hangar-operator oci://ghcr.io/mcp-hangar/charts/mcp-hangar-operator \
  --namespace mcp-hangar

Pin a version: these commands install the latest published charts. For a reproducible deploy, add --version <x.y.z> from the release compatibility matrix, which is the single source of truth for which core, operator, and chart versions are released and tested together (never hardcoded here -- see ADR-011).

Server auth behavior (fail-closed on a non-loopback bind, unsafeNoAuth) is owned by the core README, not re-documented here.

Install from Source

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

helm install mcp-hangar ./mcp-hangar -n mcp-hangar
helm install mcp-hangar-operator ./mcp-hangar-operator -n mcp-hangar

Chart Overview

mcp-hangar

The core application chart for the MCP Hangar server.

Key configuration options in values.yaml:

• replicaCount: Number of server instances.
• image: Container image repository and tag.
• config.mcp_servers: Backend MCP servers the gateway fronts.
• config.unsafeNoAuth / auth: bind without auth (demo) or configure OIDC/API-key auth.
• service: Service type and port configuration.
• resources: Pod resource requests and limits.
• serviceMonitor: Enable Prometheus monitoring.

mcp-hangar-operator

The Kubernetes operator manages the lifecycle of MCP providers.

Key configuration options in values.yaml:

• replicaCount: Number of operator instances.
• image: Operator container image.
• CRDs: Manage Custom Resource Definition installation.
• rbac: RBAC resource creation.
• resources: Pod resource requests and limits.
• metrics: Metrics service configuration.

Development

Use these commands for local development and testing.

Linting

helm lint mcp-hangar
helm lint mcp-hangar-operator

Rendering Templates

helm template mcp-hangar ./mcp-hangar
helm template mcp-hangar-operator ./mcp-hangar-operator

Packaging

helm package mcp-hangar
helm package mcp-hangar-operator

License

This project is licensed under the MIT License.

Docs | GitHub