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.

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:

HELM_MCP_BINARY environment variable
Bundled binary in the package bin/ directory
Auto-download from GitHub Releases (with SHA256 checksum verification)
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.37.tar.gz (36.6 kB view details)

Uploaded Jul 3, 2026 Source

Built Distributions

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

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

Uploaded Jul 3, 2026 Python 3Windows x86-64

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

Uploaded Jul 3, 2026 Python 3manylinux: glibc 2.17+ x86-64

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

Uploaded Jul 3, 2026 Python 3manylinux: glibc 2.17+ ARM64

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

Uploaded Jul 3, 2026 Python 3macOS 11.0+ ARM64

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

Uploaded Jul 3, 2026 Python 3macOS 10.15+ x86-64

File details

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

File metadata

Download URL: helm_mcp-0.1.37.tar.gz
Upload date: Jul 3, 2026
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.37.tar.gz
Algorithm	Hash digest
SHA256	`dd9716adc675b58b0a5b6578cfbeceaeee5de37502f9eb3c9811fb9600e0c512`
MD5	`533ae7e34b7e86b9f059c77a51bb7357`
BLAKE2b-256	`39b6e46706f5a8949df009cb36ae61a72584a6d8035c3718501da8a574f88ce4`

See more details on using hashes here.

Provenance

The following attestation bundles were made for helm_mcp-0.1.37.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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: helm_mcp-0.1.37.tar.gz
- Subject digest: dd9716adc675b58b0a5b6578cfbeceaeee5de37502f9eb3c9811fb9600e0c512
- Sigstore transparency entry: 2058426421
- Sigstore integration time: Jul 3, 2026
Source repository:
- Permalink: SCGIS-Wales/helm-mcp@c1d0e6be1ad9f1311dcde17ccb3f7f473066e64b
- Branch / Tag: refs/heads/main
- Owner: https://github.com/SCGIS-Wales
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: ci.yml@c1d0e6be1ad9f1311dcde17ccb3f7f473066e64b
- Trigger Event: push

File details

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

File metadata

Download URL: helm_mcp-0.1.37-py3-none-win_amd64.whl
Upload date: Jul 3, 2026
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.37-py3-none-win_amd64.whl
Algorithm	Hash digest
SHA256	`4cf0a8e5f7b98eaeb302fbd2221d4a080692451839c9e793a94068793fb45eb8`
MD5	`28693c2d6d94aaa122da0beb2db795fc`
BLAKE2b-256	`780d4feb786c6ca2153d394b53c8fc67fa6571b2ec672f8ff07a35a2b00e892d`

See more details on using hashes here.

Provenance

The following attestation bundles were made for helm_mcp-0.1.37-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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: helm_mcp-0.1.37-py3-none-win_amd64.whl
- Subject digest: 4cf0a8e5f7b98eaeb302fbd2221d4a080692451839c9e793a94068793fb45eb8
- Sigstore transparency entry: 2058426551
- Sigstore integration time: Jul 3, 2026
Source repository:
- Permalink: SCGIS-Wales/helm-mcp@c1d0e6be1ad9f1311dcde17ccb3f7f473066e64b
- Branch / Tag: refs/heads/main
- Owner: https://github.com/SCGIS-Wales
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: ci.yml@c1d0e6be1ad9f1311dcde17ccb3f7f473066e64b
- Trigger Event: push

File details

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

File metadata

Download URL: helm_mcp-0.1.37-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Upload date: Jul 3, 2026
Size: 26.8 MB
Tags: Python 3, manylinux: glibc 2.17+ 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.37-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm	Hash digest
SHA256	`4d56313c94bd95a568782ad1b68b9eb4efdc1e9e5873feca3458bdbffe02b652`
MD5	`85bc5b225f3d3662a36b60bc1e21bc13`
BLAKE2b-256	`7e2363b5d73293602a6be1fb816c09e7692793783ad3bbd5b835bdfe32c268c4`

See more details on using hashes here.

Provenance

The following attestation bundles were made for helm_mcp-0.1.37-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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: helm_mcp-0.1.37-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Subject digest: 4d56313c94bd95a568782ad1b68b9eb4efdc1e9e5873feca3458bdbffe02b652
- Sigstore transparency entry: 2058427075
- Sigstore integration time: Jul 3, 2026
Source repository:
- Permalink: SCGIS-Wales/helm-mcp@c1d0e6be1ad9f1311dcde17ccb3f7f473066e64b
- Branch / Tag: refs/heads/main
- Owner: https://github.com/SCGIS-Wales
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: ci.yml@c1d0e6be1ad9f1311dcde17ccb3f7f473066e64b
- Trigger Event: push

File details

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

File metadata

Download URL: helm_mcp-0.1.37-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Upload date: Jul 3, 2026
Size: 17.9 MB
Tags: Python 3, manylinux: glibc 2.17+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for helm_mcp-0.1.37-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm	Hash digest
SHA256	`a166f7c67a79e3df16821c6a2b861dd2614fee6330671f2a6449ebae1f7b9aa2`
MD5	`f187ad8f6739e3ae74c5cc74a73075a3`
BLAKE2b-256	`f173d19237f749b9f144924b0794934ce937bab712012d82d733e07feb3615d9`

See more details on using hashes here.

Provenance

The following attestation bundles were made for helm_mcp-0.1.37-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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: helm_mcp-0.1.37-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
- Subject digest: a166f7c67a79e3df16821c6a2b861dd2614fee6330671f2a6449ebae1f7b9aa2
- Sigstore transparency entry: 2058426903
- Sigstore integration time: Jul 3, 2026
Source repository:
- Permalink: SCGIS-Wales/helm-mcp@c1d0e6be1ad9f1311dcde17ccb3f7f473066e64b
- Branch / Tag: refs/heads/main
- Owner: https://github.com/SCGIS-Wales
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: ci.yml@c1d0e6be1ad9f1311dcde17ccb3f7f473066e64b
- Trigger Event: push

File details

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

File metadata

Download URL: helm_mcp-0.1.37-py3-none-macosx_11_0_arm64.whl
Upload date: Jul 3, 2026
Size: 18.8 MB
Tags: Python 3, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for helm_mcp-0.1.37-py3-none-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`51a07418bdcbe85605b0738f1fe46abaa3b15801d8020fa5393eb2b9477ec2a2`
MD5	`1ee868df7cf0f79e7549501444dfea84`
BLAKE2b-256	`0cd1b58f49295f8351f79d392ac16a13e75a1b7a8978d4494e98c91e722f177c`

See more details on using hashes here.

Provenance

The following attestation bundles were made for helm_mcp-0.1.37-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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: helm_mcp-0.1.37-py3-none-macosx_11_0_arm64.whl
- Subject digest: 51a07418bdcbe85605b0738f1fe46abaa3b15801d8020fa5393eb2b9477ec2a2
- Sigstore transparency entry: 2058427290
- Sigstore integration time: Jul 3, 2026
Source repository:
- Permalink: SCGIS-Wales/helm-mcp@c1d0e6be1ad9f1311dcde17ccb3f7f473066e64b
- Branch / Tag: refs/heads/main
- Owner: https://github.com/SCGIS-Wales
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: ci.yml@c1d0e6be1ad9f1311dcde17ccb3f7f473066e64b
- Trigger Event: push

File details

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

File metadata

Download URL: helm_mcp-0.1.37-py3-none-macosx_10_15_x86_64.whl
Upload date: Jul 3, 2026
Size: 20.7 MB
Tags: Python 3, macOS 10.15+ 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.37-py3-none-macosx_10_15_x86_64.whl
Algorithm	Hash digest
SHA256	`04c39b04b1e9395b4737edca8afbca9fb23b6ca08055ae8c472972f49eee5fce`
MD5	`10605cf4f19a940bb0cc527bfa48ce4f`
BLAKE2b-256	`2943f8c9c8f8d94107b4c13cc6bbdd63639ce92b375f59f5c3e52fb4f5235fbc`

See more details on using hashes here.

Provenance

The following attestation bundles were made for helm_mcp-0.1.37-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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: helm_mcp-0.1.37-py3-none-macosx_10_15_x86_64.whl
- Subject digest: 04c39b04b1e9395b4737edca8afbca9fb23b6ca08055ae8c472972f49eee5fce
- Sigstore transparency entry: 2058426726
- Sigstore integration time: Jul 3, 2026
Source repository:
- Permalink: SCGIS-Wales/helm-mcp@c1d0e6be1ad9f1311dcde17ccb3f7f473066e64b
- Branch / Tag: refs/heads/main
- Owner: https://github.com/SCGIS-Wales
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: ci.yml@c1d0e6be1ad9f1311dcde17ccb3f7f473066e64b
- Trigger Event: push

Release history Release notifications | RSS feed

0.1.38

Jul 3, 2026

This release

0.1.37

Jul 3, 2026

0.1.36

Jun 1, 2026

0.1.35

May 31, 2026

0.1.34

Mar 15, 2026

0.1.33

Mar 15, 2026

0.1.32

Mar 8, 2026

0.1.31

Mar 6, 2026

0.1.30

Mar 3, 2026

0.1.29

Feb 27, 2026

0.1.28

Feb 27, 2026

0.1.27

Feb 26, 2026

0.1.26

Feb 26, 2026

0.1.25

Feb 25, 2026

0.1.24

Feb 24, 2026

0.1.23

Feb 24, 2026

0.1.22

Feb 24, 2026

0.1.21

Feb 24, 2026

0.1.20

Feb 23, 2026

0.1.19

Feb 22, 2026

0.1.18

Feb 22, 2026

0.1.17

Feb 22, 2026

0.1.16

Feb 22, 2026

0.1.15

Feb 22, 2026

0.1.14

Feb 22, 2026

0.1.13

Feb 21, 2026

0.1.12

Feb 21, 2026

0.1.11

Feb 21, 2026

0.1.9

Feb 21, 2026

0.1.8

Feb 21, 2026

0.1.7

Feb 21, 2026

0.1.6

Feb 21, 2026

0.1.5

Feb 21, 2026

0.1.4

Feb 21, 2026

0.1.3

Feb 21, 2026

helm-mcp 0.1.37

helm-mcp (Python)

Requirements

Installation

Quick Start

As a server

As a client

CLI

Binary Discovery

Environment Variables

Scalability

License

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License expression

Requires

Provides Extra

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed