English Français العربية

Superserve

السجل الرسمي أخرى

MCP server for Superserve sandboxes: create, exec, and manage Firecracker microVMs

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
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_...'\''.>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "superserve": {
            "type": "http",
            "url": "https://mcp.superserve.ai",
            "headers": {
                "Authorization": "<Bearer token — your Superserve API key, e.g. 'Bearer ss_live_...'.>"
            }
        }
    }
}
NPM package @superserve/mcp
Claude Code 
claude 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
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "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"
            }
        }
    }
}

متغيرات البيئة

  • SUPERSERVE_API_KEY إلزامي سري Superserve API key (starts with ss_live_). Create one at https://console.superserve.ai.
  • SUPERSERVE_BASE_URL Override the Superserve control-plane API base URL. Defaults to https://api.superserve.ai.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Getting Started
  2. Structure
  3. Setup
  4. Development
  5. SDKs
  6. Testing
  7. Releasing
  8. Contributing
  9. License
  10. Where to find us

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

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

الأسئلة الشائعة

ما هو Superserve؟

MCP server for Superserve sandboxes: create, exec, and manage Firecracker microVMs

كيف أثبّت Superserve؟

يعمل كخادم بعيد. في 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_...'\''.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Superserve إلى مفتاح API؟

نعم. يتطلب SUPERSERVE_API_KEY, Authorization، وتضبطها في إعداداته.

هل Superserve مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص Apache-2.0.

من يصون Superserve؟

ينشره superserve-ai. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.