Recipe

mcp-remote

A Model Context Protocol server someone else already runs, reached at the address infra.endpoint names, as a reference realization for local development via Docker Compose: no service is defined for it and nothing runs. The address reaches a consuming service through the injection context rather than through a service definition, because compose has no counterpart to an in-cluster alias. provides.endpoint is the address as written, host, port and protocol are read from it, and credential_header is the request header the server reads a caller's credential from, Authorization unless infra.credential_header names another. No credential is held here: a consumer that needs one holds it on its own connection to the tool and presents it under that header, because the credential belongs to the consumer rather than to the address. infra.endpoint is the address without any part that carries a key, at least a scheme and a host; a consumer whose server reads its key from the address supplies the whole address through the endpoint slot on its own connection, as a Compose variable reference. An address carrying a user name or password is refused. Reach for this realization under Docker Compose where the server already runs outside the Release; reach for helm/mcp-remote on Kubernetes, for compose/mcp to run a server shipped as an image serving HTTP, and for compose/mcp-stdio-bridge to run a server published as a package speaking stdio. infra.image, the two stdio keys, infra.published_port and a server_env attachment are refused here, and so is an `inject:` block, on a connection from the tool or on the component itself, since no container runs to receive it.

Version

1.0.01.1.0

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:28d0c04738a64fc77352156750e0c26c5174bc20a71eac0269bd29f843a04d49
Published
2026-11-15T08:09:23Z
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:0d24a158e46136ba68b950cb994ff781bc272b29c6bc982f9364e79ae93a1e13

Reference at this version

oci://hub.aggrega.ai/recipe/compose/mcp-remote:1.1.0
Target
—
Implements
core/ai-tool/mcp:1.1.0

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
host{{ .locals.hostname }}
port{{ .locals.port }}
endpoint{{ .locals.endpoint }}
protocol{{ .locals.scheme }}
credential_header{{ .infra.credential_header }}

Workload

Workload · form: reference

Locals

NameTemplate
endpoint{{ optional .infra "endpoint" "" }}
scheme{{ (urlParse .locals.endpoint).scheme }}
hostname{{ (urlParse .locals.endpoint).hostname }}
port{{ $u := urlParse .locals.endpoint }}{{ $p := regexFind ":[0-9]+
quot; $u.host | trimPrefix ":" }}{{ if $p }}{{ $p }}{{ else if eq $u.scheme "http" }}80{{ else }}443{{ end }}

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.

Recipe concept reference →

The Aggrega catalog — an open index of components, features, recipes, and the plugins that render them.

Built with the shared Aggrega design system.

Privacy