Superserve

Superserve — MCP-сервер сообщества (автор — superserve-ai). Песочницы Superserve на микро-ВМ Firecracker: создание и выполнение команд. Ставится через npx. Доступен и как удалённый сервер. Лицензия Apache-2.0.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
superserve-ai
Лицензия
Apache-2.0
Транспорт
stdio, streamable_http
Авторизация
api_key
ОС
Не указана
Языки
typescript

Уровень риска: high

Произвольные команды в микро-ВМ Superserve от имени аккаунта; создание и удаление песочниц расходует ресурсы команды; привязка секретов; публичные ссылки на порты.

Настройка клиентов

codex
{
    "code": "[mcp_servers.superserve]\ncommand = \"npx\"\nargs = [\"-y\", \"-p\", \"@superserve/mcp\", \"superserve-mcp\"]\nenv_vars = [\"SUPERSERVE_API_KEY\"]",
    "file": "~/.codex/config.toml",
    "lang": "toml",
    "notes": "Дословно из README; env_vars берёт ключ из окружения",
    "verified": "docs"
}

Что умеет

@superserve/mcp — MCP-сервер для песочниц Superserve: изолированных микро-ВМ на Firecracker. Через него ассистент создаёт песочницы, выполняет в них команды и управляет ими. Сервер работает локально через stdio (npx), авторизуется по API-ключу Superserve и в каждом вызове обращается к конкретной песочнице по её id. Есть и облачный экземпляр по адресу https://mcp.superserve.ai.

Инструменты по README:

  • жизненный цикл: sandbox_create, sandbox_update, sandbox_list, sandbox_info, sandbox_pause, sandbox_resume, sandbox_kill;
  • выполнение: sandbox_exec запускает shell-команду и возвращает stdout, stderr и код выхода (приостановленная песочница при этом возобновляется);
  • рабочий стол: sandbox_computer управляет графической песочницей: скриншоты, мышь, клавиатура, ссылка на живой просмотр;
  • файлы: чтение (до 1 МиБ), запись, список папки, выгрузка папки ZIP-архивом (до 10 МиБ);
  • сеть: sandbox_preview_url публикует порт и даёт публичную или приватную подписанную ссылку, sandbox_network_log показывает исходящие соединения;
  • шаблоны: список и сборка собственных шаблонов (vCPU, память, диск, предустановленное ПО);
  • секреты: список секретов команды (только метаданные), привязка секрета к песочнице как переменной окружения и отвязка. Создавать секреты через MCP нельзя — это намеренно.

Кому подойдёт

  • Разработчикам агентов, которым нужно безопасно выполнять сгенерированный код вне своей машины.
  • Командам с аккаунтом Superserve, которые хотят управлять песочницами из Cursor, VS Code, Claude Code или Codex.

Другие серверы для инфраструктуры — в категории облака и DevOps.

Установка

Нужен Node.js (npx) и API-ключ Superserve: его создают в console.superserve.ai. Задайте SUPERSERVE_API_KEY в блоке env клиента: клиенты не наследуют переменные из вашей оболочки. Необязательная переменная SUPERSERVE_BASE_URL по умолчанию равна https://api.superserve.ai.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

.vscode/mcp.json
{
  "inputs": [
    {
      "id": "superserve-key",
      "type": "promptString",
      "description": "Superserve API key",
      "password": true
    }
  ],
  "servers": {
    "superserve": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "-p", "@superserve/mcp", "superserve-mcp"],
      "env": { "SUPERSERVE_API_KEY": "${input:superserve-key}" }
    }
  }
}

VS Code запрашивает ключ при запуске, а Codex через env_vars берёт его из окружения и не хранит в файле. Такой же JSON, как для Cursor, README приводит для Claude Desktop (claude_desktop_config.json) и Windsurf (mcp_config.json); для Claude Code есть команда claude mcp add.

Облачный вариант. Экземпляр https://mcp.superserve.ai работает по Streamable HTTP без локальной установки; ключ передаётся как bearer-токен. Это работает в Claude Code, Cursor и VS Code. Claude.ai, интерфейс пользовательских коннекторов Claude Desktop и режим разработчика ChatGPT ждут OAuth, который облачный экземпляр не поддерживает. Тело запроса ограничено примерно 4,5 МБ.

Проверка

Попросите ассистента вывести список шаблонов или песочниц. Затем создайте песочницу и выполните в ней uname -a, чтобы проверить sandbox_exec.

Примеры задач

Создай песочницу, склонируй в неё мой репозиторий, установи зависимости и прогони тесты.
Подними в песочнице dev-сервер на порту 3000 и дай приватную ссылку на превью.

Риски

  • Выполнение команд. sandbox_exec запускает произвольные shell-команды. Это происходит внутри изолированной микро-ВМ, а не на вашей машине, но от имени вашего аккаунта Superserve.
  • Действия в аккаунте. Сервер создаёт, изменяет и удаляет песочницы и шаблоны и меняет правила исходящего трафика. Песочницы расходуют ресурсы вашей команды в Superserve; удаление через sandbox_kill необратимо.
  • Секреты. Инструменты привязывают секреты команды к песочницам; значения не возвращаются, создавать секреты через MCP нельзя. Не храните API-ключ в файле конфигурации, если клиент умеет его запрашивать (VS Code) или брать из окружения (Codex).
  • Публичные ссылки. sandbox_preview_url может открыть порт песочницы в интернет; используйте приватные ссылки, если доступ нужен только вам.
  • Ключ привязан к команде: облачный сервер не хранит состояние и не пишет ключ в логи.

Частые вопросы

Чем локальный режим отличается от облачного?

Локальный запускается через npx по stdio. Облачный работает по HTTP с bearer-ключом и ограничивает размер запроса примерно 4,5 МБ.

Где взять ключ?

В консоли Superserve: console.superserve.ai.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

GitHub MCP Server

Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники