yadayac/reshapr-inside-sbx

By yadayac

•Updated about 7 hours ago

Docker sbx kit: runs a reShapr MCP server inside the sandbox. No host setup, no API key.

Sandbox Kit

API management

Machine learning & AI

Developer tools

Overview Tags

yadayac/reshapr-inside-sbx repository overview

Tag

Digest

sha256:4b3a743f8a29…

Size

2.3 kB

Schema

Pushed

about 7 hours ago

Specificationspec.yaml

MIXIN

Runs reShapr (postgres, control plane, MCP server) in the sandbox's own Docker daemon, imports an OpenAPI as an MCP server and registers it with the agent.

Arguments

Name	Required	Default	Description
`backend`	Optional	`https://api.open-meteo.com`	Base URL of the backend API behind the OpenAPI document.
`exposition`	Optional	`reshapr/open-meteo-weather-forecast-api-1-0-default`	<organization>/<exposition-name> path of the imported exposition (see `reshapr expo list`).
`openapi`	Optional	`https://raw.githubusercontent.com/open-meteo/open-meteo/refs/heads/main/openapi/forecast.yml`	URL of the OpenAPI document to expose as an MCP server.
`release`	Optional	`1.0.0`	reShapr release (images and CLI).

CapabilitiesExpand a row to see its full configuration. See the full spec for the complete descriptor.

Type	Required	Description
`com.docker.sandbox/network-policy@1`	Required	—

`com.docker.sandbox/long-running@1`	Required	—
`com.docker.sandbox/lifecycle@1`	Required	—

`com.docker.sandbox/agent-context@1`	Required	—

Apply this mixin to a sandbox

sbx run <agent> --kit yadayac/reshapr-inside-sbx:0.3.0

Make sure you have docker sbx installed

Run the following command to install sbx on your machine.

macOS

brew install docker/tap/sbx

Windows

winget install Docker.sbx

Learn more about docker sbx⁠

⁠reshapr-inside-sbx

A Docker Sandboxes (sbx)⁠ kit that runs a reShapr⁠ MCP server inside the sandbox, in the sandbox's own Docker daemon, and registers it with the agent. Nothing runs on your host, and there is no API key to manage.

reShapr turns REST, GraphQL and gRPC APIs into MCP tools. By default the kit imports the public Open-Meteo weather API, so you can try it right away.

⁠Use

sbx create docker.io/docker/sbx-kit-claude:2.1.296 --name reshapr-in \
  --kit docker.io/yadayac/reshapr-inside-sbx:0.3.0
# reShapr starts in the background; wait for the import to finish:
sbx exec reshapr-in tail -3 /tmp/reshapr-start.log   # ends with an "Endpoints" line
sbx run reshapr-in

Ask: "give the forecast in SFO". Works with Claude, Codex and Copilot workloads.

⁠Use your own API

sbx create <workload> --kit docker.io/yadayac/reshapr-inside-sbx:0.3.0 \
  --kit-arg openapi=<openapi-url> --kit-arg backend=<api-base-url> \
  --kit-arg exposition=<org>/<exposition-name>

Args: release (default 1.0.0), openapi, backend, exposition. Allow the hosts of your OpenAPI document and backend with sbx policy allow network <host>. The exposition path comes from the API title and version (reshapr expo list inside the sandbox).

⁠Good to know

Takes about a minute to start and uses about 1 GB of RAM.
The API is re-imported on every boot (the database is not persisted).
A session opened before the import finishes has no reShapr tools and may fall back to web search.
The kit allows registry.reshapr.io, quay.io, cdn01.quay.io, raw.githubusercontent.com and api.open-meteo.com.

⁠Verify the signature

sbx kit verify docker.io/yadayac/reshapr-inside-sbx:0.3.0 \
  --certificate-identity [email protected] \
  --certificate-oidc-issuer https://github.com/login/oauth

⁠Details

Spec v3 mixin, multi-arch (linux/amd64, linux/arm64), published with provenance, signed with Sigstore (keyless).
Requires sbx 0.50.0 or later.
Full guide and tests: https://github.com/yada/reshapr-sbx-poc⁠
Prefer reShapr on your host with the key kept out of the sandbox? See reshapr-outside-sbx⁠.

⁠License

Apache License 2.0⁠