Sign inSign up

yadayac/reshapr-outside-sbx

By yadayac

•Updated about 8 hours ago

Docker sbx kit: reShapr MCP server on your host, behind the sbx MCP gateway. API key stays on host.

Sandbox Kit
API management
Machine learning & AI
Developer tools
0

56

yadayac/reshapr-outside-sbx repository overview

Digest

sha256:315d43e34307…

Size

824 Bytes

Schema

v3

Pushed

about 8 hours ago

Specificationspec.yaml

MIXIN

Agent context for a reShapr MCP server running on the host and exposed through the sbx MCP gateway. The API key stays on the host.


CapabilitiesExpand a row to see its full configuration. See the full spec for the complete descriptor.
TypeRequiredDescription
com.docker.sandbox/agent-context@1Required—

Apply this mixin to a sandbox

sbx run <agent> --kit yadayac/reshapr-outside-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-outside-sbx

A Docker Sandboxes (sbx)⁠ kit that gives a sandboxed coding agent governed access to your APIs through a reShapr⁠ MCP server running on your host.

reShapr turns REST, GraphQL and gRPC APIs into MCP tools, with API-key auth, audit and trimmed responses. The sbx MCP gateway adds the API key on the host, so the key never enters the sandbox.

The kit itself is agent context only: it tells the agent that the reShapr tools appear unprefixed behind mcp-gateway (for example get_v1_forecast), and to prefer them over web search.

⁠Use

On the host, start reShapr and register it with the sbx MCP gateway (set the secret first):

sbx secret set mcp:reshapr:api-key < api-key.txt
sbx mcp add reshapr --url http://localhost:7777/mcp/<org>/<exposition> \
  --header 'x-reshapr-key: ${api-key}' --skip-ssrf-check

Create the sandbox with the kit and a v3 workload (Claude, Codex or Copilot):

sbx create docker.io/docker/sbx-kit-claude:2.1.296 --name reshapr-out \
  --static-mcp reshapr --kit docker.io/yadayac/reshapr-outside-sbx:0.3.0
sbx run reshapr-out

Codex works best when the prompt says "using the reshapr tool".

⁠Verify the signature

sbx kit verify docker.io/yadayac/reshapr-outside-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, demo script and tests: https://github.com/yada/reshapr-sbx-poc⁠
  • Want reShapr inside the sandbox instead? See reshapr-inside-sbx⁠.
  • Upgrading from reshapr-kit:0.2.0: the hooks, credential and network rule are gone; see the migration note in the repo README.

⁠License

Apache License 2.0⁠