# Superserve

Даёт агенту доступ к изолированным микро-VM Firecracker: создать песочницу, выполнить команду, поработать с файлами. Пригодится, когда код надо запускать вне основной машины.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 467
- Автор: superserve-ai
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/superserve-ai/superserve/tree/HEAD/packages/mcp
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/superserve

## Что делает

Superserve подключается к MCP-клиенту и работает с песочницами Superserve. Локально запускается через `npx` по stdio, каждый вызов адресует песочницу по `id`. Есть и удалённый вариант на `https://mcp.superserve.ai` по Streamable HTTP — тогда локальная установка не нужна, а ключ уходит в заголовке bearer.

Инструментов много: `sandbox_create` заводит песочницу и возвращает `id`, `sandbox_exec` выполняет shell-команду и отдаёт stdout, stderr и код возврата, `sandbox_files_read` и `sandbox_files_write` работают с файлами. Отдельно стоит `sandbox_computer` — он управляет GUI-десктопом: скриншот, мышь, клавиатура, прокрутка, ссылка на живой просмотр. Ещё есть пауза, возобновление, удаление, публикация порта через `sandbox_preview_url` и аудит исходящих соединений.

Ключ `SUPERSERVE_API_KEY` клиенты не наследуют из оболочки, его надо прописать в `env` конфигурации. Удалённый эндпоинт принимает статический bearer, а вот Claude.ai, Custom Connector в Claude Desktop и режим разработчика в ChatGPT ждут OAuth, которого там пока нет. Чтение файла отклоняется, если он больше 1 MiB, а скачивание каталога в ZIP упирается в 10 MiB.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://mcp.superserve.ai`
- Переменные окружения: `SUPERSERVE_API_KEY`, `SUPERSERVE_BASE_URL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы**
```bash
claude mcp add --env SUPERSERVE_API_KEY=<SUPERSERVE_API_KEY> --env SUPERSERVE_BASE_URL=<SUPERSERVE_BASE_URL> --transport stdio mcp -- npx -y @superserve/mcp
```
Вместо <…> подставьте свои значения

2. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http mcp https://mcp.superserve.ai
```

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add mcp --url https://mcp.superserve.ai
```

2. **Командой платформы**
```bash
codex mcp add mcp --env SUPERSERVE_API_KEY=<SUPERSERVE_API_KEY> --env SUPERSERVE_BASE_URL=<SUPERSERVE_BASE_URL> -- npx -y @superserve/mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "url": "https://mcp.superserve.ai"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@superserve/mcp"
            ],
            "env": {
                "SUPERSERVE_API_KEY": "<SUPERSERVE_API_KEY>",
                "SUPERSERVE_BASE_URL": "<SUPERSERVE_BASE_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "http",
            "url": "https://mcp.superserve.ai"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@superserve/mcp"
            ],
            "env": {
                "SUPERSERVE_API_KEY": "<SUPERSERVE_API_KEY>",
                "SUPERSERVE_BASE_URL": "<SUPERSERVE_BASE_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http mcp https://mcp.superserve.ai
```

2. **Командой платформы**
```bash
gemini mcp add -e SUPERSERVE_API_KEY=<SUPERSERVE_API_KEY> -e SUPERSERVE_BASE_URL=<SUPERSERVE_BASE_URL> mcp npx -y @superserve/mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- запустить незнакомый код в изоляции от рабочей машины
- выполнить shell-команду и забрать её вывод
- прочитать или записать файл внутри песочницы
- опубликовать порт и получить ссылку на превью
- посмотреть, куда песочница ходила по сети

## Примеры запросов агенту
- Создай песочницу и выполни в ней `npm test`
- Запиши этот скрипт в файл внутри песочницы и запусти его
- Сделай скриншот десктопа в песочнице и покажи, что на экране

## Похожие
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [Oh My Posh Validator](https://affpapa.org/nevibecode/mcp/oh-my-posh-validator.md) — MCP-сервер · ★ 23643
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18727
- [Coder](https://affpapa.org/nevibecode/mcp/coder.md) — MCP-сервер · ★ 17160
- [mcp](https://affpapa.org/nevibecode/mcp/kubeshark-mcp.md) — MCP-сервер · ★ 12109

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md