Recipe

mcp

The Model Context Protocol server tool on Docker Compose, for local development: one service running the image the Release names in infra.image, serving the protocol over HTTP on infra.port, where an agent on the compose network reaches it at the service's name. Where the Release sets infra.published_port, that port on the host's loopback address, 127.0.0.1, forwards to infra.port; unset, nothing is published, and two servers that each publish take distinct published_port values. The tool packages no upstream product, so a build with no image set halts and names the key. provides publishes host, port, endpoint, protocol and credential_header. An edge from the tool, on a socket the author names, delivers the names its `inject:` block dictates, as variables or as files from compose configs; the component's own `inject:` block delivers its entries the same way. The server's credentials arrive through the server_env slot: attach core/referenced-secret-set mapped to compose/dotenv-secret-set, each entry's value a Compose variable reference such as ${GITHUB_TOKEN}, which Docker Compose substitutes when the stack starts. An attachment publishing only a secret resource's name, or delivering no variable, halts the build. Reach for this realization under Docker Compose where the server ships as a container image serving the protocol over HTTP; reach for helm/mcp on Kubernetes, for compose/mcp-stdio-bridge where the server is a package speaking stdio, and for compose/mcp-remote where someone else already runs it. The two stdio keys and infra.endpoint are refused here.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:611489930aecd2e175022350be97ba3f0f49c5d98d4762e928670b06ded269ee
Published
2026-11-15T08:09:26Z
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:e936ef255c864de91943c42a90404d09f49af34cf32ed6953a00639fa9c2030f

Reference at this version

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

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
host{{ .context.instance_id }}
port{{ .infra.port }}
endpointhttp://{{ .context.instance_id }}:{{ .infra.port }}
protocolhttp
credential_header{{ .infra.credential_header }}

Workload

Workload · form: stateless · containers: main

Locals

NameTemplate
inject_file_config_prefix{{ .context.instance_id }}-file-

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