Skip to main content

helm-mcp (Python)

CI/CD Pipeline PyPI version Python versions Downloads License: MIT

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.

Requirements

  • Python 3.12+
  • The helm-mcp Go 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())

CLI

# stdio mode (default, for MCP clients like Claude Code)
helm-mcp-python

# HTTP mode
helm-mcp-python --transport http --host 0.0.0.0 --port 8080

# Pre-download binary
helm-mcp-python --setup

# Explicit binary path
helm-mcp-python --binary /usr/local/bin/helm-mcp

Binary Discovery

The package locates the helm-mcp Go binary in this order:

  1. HELM_MCP_BINARY environment variable
  2. Bundled binary in the package bin/ directory
  3. Auto-download from GitHub Releases (with SHA256 checksum verification)
  4. helm-mcp on PATH

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_PLUGINS, HELM_DEBUG
AWS AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN, AWS_REGION, AWS_PROFILE
GCP GOOGLE_APPLICATION_CREDENTIALS, CLOUDSDK_COMPUTE_ZONE
Azure AZURE_TENANT_ID, AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, AZURE_SUBSCRIPTION_ID
TLS SSL_CERT_FILE, SSL_CERT_DIR

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

helm_mcp-0.1.38.tar.gz (36.6 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

helm_mcp-0.1.38-py3-none-win_amd64.whl (20.8 MB view details)

Uploaded Python 3Windows x86-64

helm_mcp-0.1.38-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (26.8 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ x86-64

helm_mcp-0.1.38-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (17.9 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ ARM64

helm_mcp-0.1.38-py3-none-macosx_11_0_arm64.whl (18.8 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

helm_mcp-0.1.38-py3-none-macosx_10_15_x86_64.whl (20.7 MB view details)

Uploaded Python 3macOS 10.15+ x86-64

File details

Details for the file helm_mcp-0.1.38.tar.gz.

File metadata

  • Download URL: helm_mcp-0.1.38.tar.gz
  • Upload date:
  • Size: 36.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for helm_mcp-0.1.38.tar.gz
Algorithm Hash digest
SHA256 fa4a02c9c9a9532d774552e82861e872f1b9e1165905c58c08b4087063ed3eb1
MD5 1e791245e598c1ffb3a151172542ef7d
BLAKE2b-256 569e33f65976e51520f64ad97a5702be2b93cf636b313f5145dada254a2d1bdc

See more details on using hashes here.

Provenance

The following attestation bundles were made for helm_mcp-0.1.38.tar.gz:

Publisher: ci.yml on SCGIS-Wales/helm-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file helm_mcp-0.1.38-py3-none-win_amd64.whl.

File metadata

  • Download URL: helm_mcp-0.1.38-py3-none-win_amd64.whl
  • Upload date:
  • Size: 20.8 MB
  • Tags: Python 3, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for helm_mcp-0.1.38-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 71073928d65b77cc358d310506577d30e2301a59d96744afbc1f60968cb8a0d7
MD5 68062110a9f5ea9b09434855cea3e189
BLAKE2b-256 2bb279ef59e8cb8f83a616e4fd7abd127695ce840a3bf1f1c0d2289c7a4377dc

See more details on using hashes here.

Provenance

The following attestation bundles were made for helm_mcp-0.1.38-py3-none-win_amd64.whl:

Publisher: ci.yml on SCGIS-Wales/helm-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file helm_mcp-0.1.38-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for helm_mcp-0.1.38-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 cff347d7f38c25321eb67794d48c713d9c91b3334361f135ae6efecbaa43d073
MD5 b771235231207cad5dff2830d5150e07
BLAKE2b-256 6a7c229b291d21b45c71bc005116b082bb3b2d6b9fd8d6b6a8cc639ea5e2a6f7

See more details on using hashes here.

Provenance

The following attestation bundles were made for helm_mcp-0.1.38-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: ci.yml on SCGIS-Wales/helm-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file helm_mcp-0.1.38-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for helm_mcp-0.1.38-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 2274e50e3455ad60bf7a0899cf7881ca8d164e599f8cffc09346aec360fc4860
MD5 8c1f0465003005530d1fb69d88860f14
BLAKE2b-256 180fa86b8ae0c562fb32c0294ef5d1ab05764bec5e28f7573b9b1091deec166f

See more details on using hashes here.

Provenance

The following attestation bundles were made for helm_mcp-0.1.38-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: ci.yml on SCGIS-Wales/helm-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file helm_mcp-0.1.38-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for helm_mcp-0.1.38-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 9b9bd4d852f7dff9f1df84e1e0b82ef2b6a24dd7784aa50a32851ca378fb9f7e
MD5 b0b92ee29d8d6e76d7c6b61d9f3e9fca
BLAKE2b-256 37fedcf04306bc6e67c5a1889d1dd52ff098450184ab85415d0761157ef7c07c

See more details on using hashes here.

Provenance

The following attestation bundles were made for helm_mcp-0.1.38-py3-none-macosx_11_0_arm64.whl:

Publisher: ci.yml on SCGIS-Wales/helm-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file helm_mcp-0.1.38-py3-none-macosx_10_15_x86_64.whl.

File metadata

File hashes

Hashes for helm_mcp-0.1.38-py3-none-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 9ff25b4f88aae843a91f33bc080eecae451a5d66a068a28883d813abd37888bc
MD5 f2d67c10544a5b76a99e18b1752e805e
BLAKE2b-256 efb02260d612ebbbcc8e5545d8e6e77c1267163e265be6690b37110b955c1edb

See more details on using hashes here.

Provenance

The following attestation bundles were made for helm_mcp-0.1.38-py3-none-macosx_10_15_x86_64.whl:

Publisher: ci.yml on SCGIS-Wales/helm-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page