Superserve MCP
MCP-сервер песочниц Superserve: агент создает изолированные микро-ВМ Firecracker, запускает в них команды и управляет файлами
- 507 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент выполняет произвольные команды и скачивает файлы в песочнице за ваш счет и от вашего ключа
- Ключ API управляет всеми песочницами команды, а секреты можно привязать к переменным окружения внутри машины
Установка
- Работает в
Ручная установка
claude mcp add superserve --env SUPERSERVE_API_KEY=ss_live_xxxxxxxxxxxxxxxx -- npx -y -p @superserve/mcp superserve-mcpЛокальный режим по stdio; подставьте свой ключ.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент выполняет произвольные команды и скачивает файлы в песочнице за ваш счет и от вашего ключа
- Ключ API управляет всеми песочницами команды, а секреты можно привязать к переменным окружения внутри машины
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Superserve — инфраструктура постоянных и безопасных песочниц для ИИ-агентов на микро-ВМ Firecracker. Пакет `@superserve/mcp` открывает ее любому MCP-клиенту: Claude, Cursor, VS Code, Windsurf и Codex. Сервер работает локально по stdio через `npx` или удаленно по адресу `https://mcp.superserve.ai` с ключом API в заголовке Bearer. Инструментов двадцать. Песочницу создают, обновляют, перечисляют и удаляют (`sandbox_create`, `sandbox_update`, `sandbox_list`, `sandbox_kill`), останавливают с сохранением состояния и возобновляют. В ней выполняют команды `sandbox_exec` и получают stdout, stderr и код выхода, а для файлов есть чтение, запись, список и скачивание каталога архивом. `sandbox_computer` управляет графическим рабочим столом: скриншот, мышь, клавиатура. Также есть публикация порта по подписанной ссылке, журнал исходящих соединений, шаблоны образов и привязка секретов к переменным окружения.
Для кого. Разработчикам агентов, которым нужно, чтобы модель запускала опасные команды, ставила пакеты и открывала браузер в отдельной машине, а не на их ноутбуке.
Подходит, если
- Агент ставит зависимости и гоняет тесты чужого репозитория внутри песочницы, а не на вашей машине
- Нужен графический рабочий стол с мышью и скриншотами для задач, где без браузера не обойтись
- Результат работы агента публикуют по подписанной ссылке на порт песочницы
- Исходящий трафик песочницы ограничивают правилами и проверяют по журналу сетевых соединений
Не подходит, если
- Достаточно разового запуска короткого кода: проще локальная WebAssembly-песочница без аккаунта и платы
- Нужен вход через OAuth в Claude.ai или ChatGPT: удаленный адрес пока принимает только статический ключ
- Файлы больше нескольких мегабайт: чтение ограничено 1 МиБ, запись примерно 4 МиБ через удаленный адрес
Пример запроса к агенту
Создай песочницу, клонируй в нее мой репозиторий, запусти тесты, покажи результат и после этого удали песочницуMCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
SUPERSERVE_API_KEYобязательная, секрет- Ключ API Superserve, начинается с ss_live_, создается в консоли
SUPERSERVE_BASE_URL- Адрес управляющего API, по умолчанию https://api.superserve.ai
Ограничения
Нужен ключ API, который начинается с `ss_live_` и создается в консоли console.superserve.ai; клиенты не наследуют переменную из оболочки, ключ задают в `env` конфигурации. Удаленный адрес не поддерживает OAuth: Claude.ai, пользовательские коннекторы Claude Desktop и режим разработчика ChatGPT с ним не подключатся. Чтение файла ограничено 1 МиБ, запись через удаленный адрес примерно 4 МиБ, архив каталога 10 МиБ. Создание секретов через сервер намеренно не вынесено в сервер: значения вводят в консоли или SDK. Версия пакета в реестре MCP 0.3.4.
Как отключить. Удалите блок superserve из конфигурации клиента (`claude mcp remove superserve`), удалите песочницы и отзовите ключ в консоли.
Частые вопросы
Как подключить Superserve к Claude Code?
Локально: `claude mcp add superserve --env SUPERSERVE_API_KEY=ss_live_xxxxxxxxxxxxxxxx -- npx -y -p @superserve/mcp superserve-mcp`. Удаленно: `claude mcp add --transport http superserve https://mcp.superserve.ai --header "Authorization: Bearer ss_live_..."`.
Где взять ключ API?
В консоли console.superserve.ai. Ключ начинается с `ss_live_` и в клиентах MCP его указывают в блоке `env`, потому что клиенты не берут переменные из вашей оболочки.
Что происходит с песочницей после паузы?
Состояние сохраняется. Инструмент `sandbox_exec` сам возобновляет приостановленную песочницу, поэтому `sandbox_resume` обычно не нужен.
Может ли агент создать секреты?
Нет, создание секретов намеренно не вынесено в MCP, чтобы значение не попало в историю агента. Сохраненные секреты перечисляет `secret_list` без значений, а привязывают их к переменной окружения через `sandbox_attach_secret`.
Есть ли SDK для кода?
Да, `@superserve/sdk` для TypeScript и пакет `superserve` на PyPI. Монорепозиторий также содержит CLI, консоль и документацию.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыМост для MCP: один инструмент run_python запускает код в контейнере и вызывает ваши MCP-серверы
Агент-конструктор MCP подбирает серверы из официального реестра и собирает из них свой агентский MCP-сервер.
Докер-контейнер с браузером, терминалом, файлами, VS Code и MCP-сервисами внутри для безопасного запуска действий агента в изоляции
Универсальный CLI-клиент MCP от Apify: постоянные сессии, OAuth, JSON-вывод для скриптов и доступ агента к любому MCP-серверу через оболочку
MCP-сервер запускает субагентов, описанных в Markdown, через Codex, Claude Code, Cursor CLI и другие CLI из любого MCP-клиента
MCP-сервер реестра HeyClaude только для чтения: агент ищет скиллы, MCP-серверы и хуки и получает готовые команды установки
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Superserve (эта карточка) | да | API-ключ | 507 | |
| Ephemeral Sandbox | нет | не нужна | 125 | песочница для кода одноразового использования, а не постоянная микро-ВМ с рабочим столом и привязкой секретов |
| Agent-Sandbox | нет | ключ необязателен | 232 | собственная песочница на Kubernetes, а не облачная служба на Firecracker |
Коротко о README
Основной README короткий: песочницы на Firecracker, структура монорепозитория (консоль, CLI, SDK на TypeScript и Python, MCP), команды разработки и ссылки на документацию. Подробности про инструменты и установку сервера лежат в `packages/mcp/README.md`.