Superserve
MCP server for Superserve sandboxes: create, exec, and manage Firecracker microVMs
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http superserve 'https://mcp.superserve.ai' --header 'Authorization: <Bearer token — your Superserve API key, e.g. '\''Bearer ss_live_...'\''.>'
{
"mcpServers": {
"superserve": {
"type": "http",
"url": "https://mcp.superserve.ai",
"headers": {
"Authorization": "<Bearer token — your Superserve API key, e.g. 'Bearer ss_live_...'.>"
}
}
}
}
@superserve/mcpclaude mcp add superserve -e 'SUPERSERVE_API_KEY=<your superserve_api_key>' -e 'SUPERSERVE_BASE_URL=https://api.superserve.ai' -- npx -y @superserve/mcp@0.3.3
{
"mcpServers": {
"superserve": {
"command": "npx",
"args": [
"-y",
"@superserve/mcp@0.3.3"
],
"env": {
"SUPERSERVE_API_KEY": "<your superserve_api_key>",
"SUPERSERVE_BASE_URL": "https://api.superserve.ai"
}
}
}
}
Variables d'environnement
SUPERSERVE_API_KEYobligatoire secret Superserve API key (starts with ss_live_). Create one at https://console.superserve.ai.SUPERSERVE_BASE_URLOverride the Superserve control-plane API base URL. Defaults to https://api.superserve.ai.
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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
Questions fréquentes
Qu'est-ce que Superserve ?
MCP server for Superserve sandboxes: create, exec, and manage Firecracker microVMs
Comment installer Superserve ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http superserve 'https://mcp.superserve.ai' --header 'Authorization: <Bearer token — your Superserve API key, e.g. '\''Bearer ss_live_...'\''.>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour Superserve ?
Oui. Il attend SUPERSERVE_API_KEY, Authorization, à renseigner dans sa configuration.
Superserve est-il open source ?
Oui. Son code est sur GitHub sous licence Apache-2.0.
Qui maintient Superserve ?
Il est publié par superserve-ai. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.