Superserve Sandbox

Created By

superserve-aia month ago

The Superserve MCP server lets any MCP client create and control isolated cloud sandboxes - each one a Firecracker microVM that boots in seconds. Your agent can run shell commands, read and write files, install dependencies, and expose a running server as a public preview URL, then pause or delete the sandbox when it’s done. Secrets are brokered by the platform so credentials never pass through the model, and outbound network access is controllable per sandbox. Works with Claude, Cursor, VS Code, Windsurf, and Codex. Run it locally with npx -y @superserve/mcp, or connect to the hosted endpoint at mcp.superserve.ai - both authenticate with your Superserve API key.

# sandbox

# agent

Overview Content Tools Comments

Overview

Persistent and secure sandboxes for AI Agents, powered by Firecracker microVMs.

Getting Started

Visit superserve.ai or jump straight into the docs.

Structure

apps/
  console/                 # Sandbox dashboard (Next.js 16, App Router)
  ui-docs/                 # UI component docs (Vite)
packages/
  cli/                     # TypeScript CLI (@superserve/cli)
  python-sdk/              # Python SDK (superserve on PyPI)
  sdk/                     # TypeScript SDK (@superserve/sdk)
  ui/                      # Shared UI components (@superserve/ui)
  typescript-config/       # Shared tsconfig presets
  tailwind-config/         # Shared Tailwind config
docs/                      # Mintlify documentation site
tests/                     # SDK end-to-end tests

Monorepo managed with Bun workspaces, Turborepo, and uv workspaces.

Setup

bun install               # install all JS/TS dependencies
uv sync                   # install all Python dependencies

Development

bun run dev               # start all dev servers
bun run build             # build all packages
bun run lint              # lint all packages
bun run format            # format all files
bun run typecheck         # type check all packages
bun run test              # unit/integration tests

For more (per-package targets, dependency management, etc.), see CONTRIBUTING.md.

SDKs

TypeScript: @superserve/sdk — bun add @superserve/sdk
Python: superserve — uv add superserve

Full reference at docs.superserve.ai.

Testing

bun run test                                        # unit tests (no credentials)
SUPERSERVE_API_KEY=ss_live_... bun run test:e2e     # e2e against staging

For environment overrides and single-language runs, see CONTRIBUTING.md.

Releasing

See RELEASING.md for publishing the SDKs to npm and PyPI.

Contributing

Contributions welcome — see CONTRIBUTING.md for guidelines.

License

Apache License 2.0 — see LICENSE.

Where to find us

Server Config

{
  "mcpServers": {
    "superserve": {
      "url": "https://mcp.superserve.ai",
      "headers": {
        "Authorization": "Bearer <YOUR_SS_LIVE_KEY>"
      }
    }
  }
}

Recommend Servers

TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.

RedisA Model Context Protocol server that provides access to Redis databases. This server enables LLMs to interact with Redis key-value stores through a set of standardized tools.

MCP AdvisorMCP Advisor & Installation - Use the right MCP server for your needs

Playwright McpPlaywright MCP server

Zhipu Web SearchZhipu Web Search MCP Server is a search engine specifically designed for large models. It integrates four search engines, allowing users to flexibly compare and switch between them. Building upon the web crawling and ranking capabilities of traditional search engines, it enhances intent recognition capabilities, returning results more suitable for large model processing (such as webpage titles, URLs, summaries, site names, site icons, etc.). This helps AI applications achieve "dynamic knowledge acquisition" and "precise scenario adaptation" capabilities.

MiniMax MCPOfficial MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.

AiimagemultistyleA Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.

Serper MCP ServerA Serper MCP Server

Baidu Map百度地图核心API现已全面兼容MCP协议，是国内首家兼容MCP协议的地图服务商。

CursorThe AI Code Editor

ChatWiseThe second fastest AI chatbot™