helm-mcp (Python)
A Python MCP wrapper for the helm-mcp Go server.
Uses FastMCP to create a transparent proxy around the helm-mcp Go binary, exposing all Helm tools via the Model Context Protocol. New tools added to the Go binary are automatically available without any Python code changes.
Removed in 0.2.0:
--transport sse. The MCP specification deprecates the HTTP+SSE transport and the Go server no longer serves it. Use--transport http.
Requirements
- Python 3.12+
- The
helm-mcpGo binary is automatically downloaded on first use (with SHA256 checksum verification)
Installation
pip install helm-mcp
Quick Start
As a server
from helm_mcp import create_server
server = create_server()
server.run() # stdio mode (default)
As a client
import asyncio
from helm_mcp import create_client
async def main():
async with create_client() as client:
tools = await client.list_tools()
print(f"Available tools: {len(tools)}")
result = await client.call_tool("helm_list", {"namespace": "default"})
print(result)
asyncio.run(main())
HelmClient wraps every tool with typed methods. Keyword arguments are passed
straight to the tool, so arguments added to the Go server work without a new
Python release, and arguments you leave out keep Helm's defaults:
from helm_mcp import HelmClient
async with HelmClient() as helm:
await helm.install(
"web",
"oci://registry.example.com/charts/web",
namespace="prod",
values={"image": {"tag": "2.0"}}, # deep merged, like --set
set_string=["build.id=007"],
wait=True,
)
CLI
# stdio mode (default, for MCP clients like Claude Code)
helm-mcp-python
# HTTP mode (Streamable HTTP). Loopback only by default: the proxy has no
# authentication, so binding elsewhere needs --allow-remote
helm-mcp-python --transport http --port 8080
# Pre-download binary
helm-mcp-python --setup
# Explicit binary path
helm-mcp-python --binary /usr/local/bin/helm-mcp
Binary Discovery
Both the helm-mcp and helm-mcp-python commands locate the Go binary the
same way, via helm_mcp.discovery:
HELM_MCP_BINARYenvironment variable- Bundled binary in the package
bin/directory (platform wheels) helm-mcponPATH— pip console-script wrappers are skipped, so ago installor Homebrew build wins over a network fetch- Auto-download from GitHub Releases (with SHA256 checksum verification)
Environment Variables
The proxy forwards these environment variables to the Go binary:
| Category | Variables |
|---|---|
| Proxy | HTTP_PROXY, HTTPS_PROXY, NO_PROXY (and lowercase variants) |
| Kubernetes | KUBECONFIG, KUBERNETES_SERVICE_HOST, KUBERNETES_SERVICE_PORT |
| Helm | HELM_CACHE_HOME, HELM_CONFIG_HOME, HELM_DATA_HOME, HELM_DRIVER, HELM_PLUGINS, HELM_DEBUG, HELM_REGISTRY_CONFIG, HELM_REPOSITORY_CACHE, HELM_REPOSITORY_CONFIG |
| AWS | AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN, AWS_REGION, AWS_DEFAULT_REGION, AWS_PROFILE, AWS_SHARED_CREDENTIALS_FILE, AWS_CONFIG_FILE |
| GCP | GOOGLE_APPLICATION_CREDENTIALS, CLOUDSDK_COMPUTE_ZONE, CLOUDSDK_COMPUTE_REGION, CLOUDSDK_CORE_PROJECT |
| Azure | AZURE_TENANT_ID, AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, AZURE_SUBSCRIPTION_ID, AZURE_AUTHORITY_HOST |
| TLS | SSL_CERT_FILE, SSL_CERT_DIR, REQUESTS_CA_BUNDLE |
The full list is helm_mcp.server.PASSTHROUGH_ENV_VARS.
Resilience
HelmClient and the proxy server wrap every call in a configurable resilience
stack — timeouts, retries with exponential backoff and jitter, a circuit
breaker, a concurrency bulkhead, optional rate limiting and response caching,
and optional OpenTelemetry tracing. Everything is configurable in code via
ResilienceConfig, or from the environment:
| Variable | Default | Effect |
|---|---|---|
HELM_MCP_TIMEOUT |
300 |
Per-call timeout in seconds |
HELM_MCP_RETRY_ENABLED |
true |
Retry transient connection failures |
HELM_MCP_RETRY_MAX_ATTEMPTS |
3 |
Attempts before giving up |
HELM_MCP_CIRCUIT_BREAKER_ENABLED |
true |
Trip after repeated connection failures |
HELM_MCP_BULKHEAD_MAX_CONCURRENT |
10 |
Concurrent in-flight tool calls |
HELM_MCP_RATE_LIMIT_ENABLED |
false |
Client-side rate limiting |
HELM_MCP_CACHE_ENABLED |
false |
Cache responses |
HELM_MCP_OTEL_ENABLED |
false |
Export traces (needs the otel extra) |
The corresponding CLI flags are --no-retry, --no-circuit-breaker,
--rate-limit, --cache, --bulkhead-max and --otel.
Scalability
This package uses the MCP proxy pattern: the Python layer never needs to know about individual Helm tools. All tool discovery, input schemas, and invocations are forwarded to the Go binary via the MCP protocol at runtime. When new capabilities are added to the Go server, they are immediately available through the Python wrapper.
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for helm-mcp 0.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| helm_mcp-0.5.0.tar.gz | 42.3 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| helm_mcp-0.5.0-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| helm_mcp-0.5.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | Python 3 | none | Linux glibc 2.17+ x86-64 | Details |
| helm_mcp-0.5.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl | Python 3 | none | Linux glibc 2.17+ ARM64 | Details |
| helm_mcp-0.5.0-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
| helm_mcp-0.5.0-py3-none-macosx_10_15_x86_64.whl | Python 3 | none | macOS 10.15+ x86-64 | Details |
Total release size: 110.0 MB
Release files / helm_mcp-0.5.0.tar.gz
| Download URL | helm_mcp-0.5.0.tar.gz |
|---|---|
| Size | 42.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
069c6f1b110560e6c95bdf3f5424cfadda2d46be8c0e99442a8ce86367a2923c
|
|
BLAKE2b-256 checksum How to use checksums |
c24a44cf67451686c2ffb87b418b6cff018fd1f33a52bedfab5eeb1457a791c0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 10, 2026.
Transparency logRelease files / helm_mcp-0.5.0-py3-none-win_amd64.whl
| Download URL | helm_mcp-0.5.0-py3-none-win_amd64.whl |
|---|---|
| Size | 21.8 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
815a6f4214dc17ba4c18b67484fe1938025ed84e4fc884485c56ef373a615464
|
|
BLAKE2b-256 checksum How to use checksums |
cd6d2a90bb94dd661b9de6ed7a71caafd02d129f638bc7de8e58a288c4283d3a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 10, 2026.
Transparency logRelease files / helm_mcp-0.5.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | helm_mcp-0.5.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 28.2 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
36466dcd71bd1e9efbd448004a4fab2d7560f5a0fc3efb843780016add056929
|
|
BLAKE2b-256 checksum How to use checksums |
ac5d8987df9c015fc70e0e48d08ea7791516bba268be5d9522443e397edb6fe9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 10, 2026.
Transparency logRelease files / helm_mcp-0.5.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | helm_mcp-0.5.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 18.7 MB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
7572dd40ebc145cbbaad3371f57af0be217959cdcfdcf84686150b25f7a33be8
|
|
BLAKE2b-256 checksum How to use checksums |
95d657b2ac394a1e68b82087b5c87313c9cc144df7e2c779fa18150685920ce9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 10, 2026.
Transparency logRelease files / helm_mcp-0.5.0-py3-none-macosx_11_0_arm64.whl
| Download URL | helm_mcp-0.5.0-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 19.6 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
fa10a122fdd8a5650ec2520a995ba762b1cc11aec39573d2341d62d0505e0ef0
|
|
BLAKE2b-256 checksum How to use checksums |
bf2170ba90eb63f4b082714ba114e9ae1768de3afd1996b66d5371517d97c85f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 10, 2026.
Transparency logRelease files / helm_mcp-0.5.0-py3-none-macosx_10_15_x86_64.whl
| Download URL | helm_mcp-0.5.0-py3-none-macosx_10_15_x86_64.whl |
|---|---|
| Size | 21.7 MB |
| Tags | Python 3 macOS 10.15+ x86-64 |
|
SHA-256 checksum How to use checksums |
ff30e154e8c8b3b550499576ddc82dfd05d2ee56f9b742319c7cd7285aaee0fa
|
|
BLAKE2b-256 checksum How to use checksums |
e5c11e9a9251b4204ee6d0205d970ca9d994bc6c189a21390499061ba8ffc6c2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 10, 2026.
Transparency log
