SandboxOS MCP Sandbox Server

An MCP server that exposes SandboxOS sandbox operations (create, run commands, read/write files, endpoints, lifecycle) as MCP tools for AI agents and MCP-compatible clients like Claude Code.

It is built on the opensandbox Python SDK.

Install

pipx install sandboxos-mcp
# or
pip install sandboxos-mcp

This installs the sandboxos-mcp command.

Run

sandboxos-mcp \
  --api-key <API_KEY> \
  --domain api.hyperlake.cloud \
  --protocol http \
  --transport stdio

Flags:

• --transport — stdio (default) or streamable-http
• --api-key — API key (overrides OPEN_SANDBOX_API_KEY)
• --domain — API domain (overrides OPEN_SANDBOX_DOMAIN)
• --protocol — http or https
• --request-timeout-seconds — HTTP request timeout

The --api-key/--domain flags override the OPEN_SANDBOX_API_KEY / OPEN_SANDBOX_DOMAIN environment variables, which are read by the underlying opensandbox SDK. Those env var names are part of the SDK contract and are intentionally unchanged.

Register with Claude Code

claude mcp add sandboxos-sandbox --transport stdio -- \
  sandboxos-mcp \
  --api-key "$SANDBOXOS_API_KEY" \
  --domain "api.hyperlake.cloud" \
  --protocol "http"

License

Licensed under the Apache License, Version 2.0. See LICENSE.