Recipe
mcp-stdio-bridge
A Model Context Protocol server published as an npm or PyPI package that speaks only stdio, run on Kubernetes behind supergateway 4.1.0, which serves it over Streamable HTTP. The helm provider synthesizes a Deployment running the bridge image, pinned by digest, for the runtime infra.stdio_runtime names, and a ClusterIP Service on infra.port. The bridge starts the command line infra.stdio_command names, with each item quoted so it reaches the server as written; the launcher fetches the package when the server starts, so the cluster reaches the package registry then. One server process runs per client session, at the path /mcp, and the bridge's /healthz endpoint is the readiness probe. provides.endpoint is the Service's address with that path. Variables the server reads its credentials from arrive through the server_env slot: every data key of the Secret its attachment names becomes one variable in the bridge's environment, by reference, and the server inherits that environment. An edge from the tool, on a socket the author names, delivers the names its `inject:` block dictates into that environment too, or as files from a ConfigMap emitted beside the Deployment. Reach for this realization where the server is a package speaking stdio; reach for helm/mcp where it ships as an image serving HTTP, for helm/mcp-remote where someone else already runs it, and for compose/mcp-stdio-bridge under Docker Compose. infra.image, infra.endpoint, infra.published_port and the component's own `inject:` block are refused here. What it renders is checked by building it; the bridge's behaviour is read from its documentation and source at the pinned release, and no run of this realization has been observed.
Version
Provenance
- Content digest
- sha256:1f786913203031fa83dc7f954b55fec546dbb121ea4f7c094d85406860631900
- Published
- 2026-11-15T08:09:44Z
- Signing identity
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Signature
- Officialapplication/vnd.dev.sigstore.bundle.v0.3+json
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
sha256:7bd159e5697f88f016f57874fd4be6be2b7ea814c7a2d046e274a74a64cca1f8
Reference at this version
oci://hub.aggrega.ai/recipe/helm/mcp-stdio-bridge:1.1.0- Target
- —
- Implements
- core/ai-tool/mcp:1.1.0
Provides
Deterministic pointer templates this recipe wires for consumers.
| Name | Template |
|---|---|
| host | {{ .context.rendered_name }}-default |
| port | {{ .infra.port }} |
| endpoint | http://{{ .context.rendered_name }}-default:{{ .infra.port }}{{ .locals.path }} |
| protocol | http |
| credential_header |
Workload
Workload · form: stateless · containers: main
Locals
| Name | Template |
|---|---|
| npm_image | ghcr.io/supercorp-ai/supergateway:4.1.0@sha256:1938c43538a5308bce07d58028e9de00b7acfecb40b39b059b2f3931800ad910 |
| pypi_image | ghcr.io/supercorp-ai/supergateway:4.1.0-uvx@sha256:660c97d4ee58498f4654e1dc60682f4f4ccab363025c9b8b415d04b4e823025e |
| path | /mcp |
| health_path | /healthz |
Values mapping
No values mapping declared.
Relationships
Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.
Uses
- implementsimplementscontract compatible
core/ai-tool/mcp:1.1.0
All required outputs are satisfied and every provided output is named in the contract.
Used by
Nothing in the catalog depends on this entity.