Agent-Sandbox MCP

Q: Как установить Agent-Sandbox?

Выполните kubectl create namespace agent-sandbox, затем kubectl apply -nagent-sandbox -f install.yaml. Нужен Kubernetes 1.28 или новее.

Q: Какие инструменты видит агент через MCP?

createSandbox, getSandbox, listSandbox, deleteSandbox и sandboxExecutor. Схему инструментов конкретной песочницы возвращают createSandbox и getSandbox.

Q: Где управлять песочницами вручную?

Во встроенном веб-интерфейсе по адресу http://agent-sandbox.your-host.com/ui, где видны песочницы, шаблоны и пулы.

Своя песочница для кода агентов на Kubernetes: REST API, MCP-сервер, совместимость с E2B и скиллы для управления ею.

230 ★ репозитория
Последний коммит 29 окт. 2026
Apache-2.0

MCP-сервер

agent-sandbox/agent-sandboxАвтор:agent-sandbox

Установка

Работает в: Claude Code
SourceCraft
Koda
Coddy

Ручная установка

kubectl create namespace agent-sandbox
kubectl apply -nagent-sandbox -f install.yaml

Установка в Kubernetes 1.28 или новее. Затем создайте ingress или `port-forward` к API-серверу.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

Агент выполняет произвольный сгенерированный код, браузер и рабочий стол в песочницах, а `ai-deploy` публикует сайты по публичным адресам.
Установка добавляет в кластер службу с доступом к объектам Kubernetes.
В README приведены пример ключа и стандартный токен администратора: пока не проверите их, экземпляр нельзя открывать наружу.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Agent-Sandbox — самостоятельно размещаемая среда выполнения песочниц для ИИ-агентов. Она ставится в Kubernetes 1.28 или новее одним `kubectl apply -f install.yaml` и хранит состояние в объектах Kubernetes: ни базы данных, ни очереди, ни CRD. Агент создает песочницу для кода на Python и JavaScript, для браузера или рабочего стола (VNC), смотрит список песочниц, получает схему их инструментов и выполняет инструменты внутри. Это делает встроенный MCP-сервер: `createSandbox`, `getSandbox`, `listSandbox`, `deleteSandbox` и `sandboxExecutor`. Тот же API совместим с протоколом E2B, поэтому подходят SDK и CLI E2B. Есть пул песочниц с прогревом, пауза и возобновление, снимки и сворачивание в ноль при простое. В `skills/` лежат скиллы `e2b`, `e2b-sandbox`, `e2b-code-interpreter` и `ai-deploy`, который публикует сгенерированный проект в песочницах с автопаузой простоя.

Для кого. Разработчики агентов и платформенные команды с кластером Kubernetes, которым нужны изолированные песочницы для кода, браузера и рабочего стола без `kubectl` на стороне агента.

Подходит, если

Агент запускает сгенерированный код и должен делать это в изоляции от других пользователей.
Нужна замена облачному E2B на своем кластере с теми же SDK.
Агенту нужен браузер или рабочий стол с VNC для проверки интерфейса.
Сгенерированный сайт нужно выложить по публичному адресу и ставить на паузу при простое (`ai-deploy`).

Не подходит, если

Кластера Kubernetes версии 1.28 или выше нет.
Нужна песочница на одном ноутбуке без кластера.
Экземпляр будет доступен из внешней сети без смены стандартного токена.

Пример запроса к агенту

Создай песочницу из шаблона sandbox-base-node, запусти в ней `npx serve -l 8008` и верни адрес.

MCP

Транспорт: http
Авторизация: ключ необязателен

Переменные окружения

`E2B_API_KEY` секрет: Ключ для E2B-совместимого API; нужен SDK E2B.
`E2B_DOMAIN`: Домен вашего экземпляра Agent-Sandbox для SDK E2B.
`E2B_API_URL`: Адрес E2B-совместимого API экземпляра, например `http://host/e2b/v1`.

Ограничения

Нужен кластер Kubernetes 1.28 или новее и доступ к API-серверу Agent-Sandbox через ingress или `port-forward`. Состояние живет в объектах Kubernetes (ConfigMap, ReplicaSet, Lease). Для E2B SDK заданы `E2B_API_KEY`, `E2B_DOMAIN` и `E2B_API_URL`. README показывает пример ключа и стандартный токен входа в веб-интерфейс администратора, поэтому не открывайте экземпляр наружу, не проверив, какие токены действуют. Подробности про аутентификацию и адрес MCP-сервера смотрите в документации проекта.

Как отключить. Удалите песочницы, ресурсы из `install.yaml` и пространство имен `agent-sandbox`. В клиенте уберите MCP-подключение.

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

Как установить Agent-Sandbox?

Выполните `kubectl create namespace agent-sandbox`, затем `kubectl apply -nagent-sandbox -f install.yaml`. Нужен Kubernetes 1.28 или новее.

Какие инструменты видит агент через MCP?

`createSandbox`, `getSandbox`, `listSandbox`, `deleteSandbox` и `sandboxExecutor`. Схему инструментов конкретной песочницы возвращают `createSandbox` и `getSandbox`.

Подходят ли SDK E2B?

Да. Протокол и SDK E2B поддержаны полностью; достаточно задать `E2B_API_KEY`, `E2B_DOMAIN` и `E2B_API_URL`.

Где управлять песочницами вручную?

Во встроенном веб-интерфейсе по адресу `http://agent-sandbox.your-host.com/ui`, где видны песочницы, шаблоны и пулы.

Нужна ли отдельная база данных?

Нет. Шаблоны, схемы развертывания и состояние песочниц хранятся в объектах Kubernetes: ConfigMap, ReplicaSet и Lease.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

Ephemeral Sandbox

Песочница на Rust для параллельных кодинг-агентов: у каждого свое рабочее пространство и общий проект, правки публикуются разом.

MCP-серверШирокий доступ124

Vercel Sandbox

Выбор редакции

Изолированные микро-ВМ Linux для кода агента: официальный скилл Vercel по SDK, сетевым правилам и снимкам.

СкиллРасширенный доступ219

Agentbox

Docker-песочница для кодинг-агентов: образ на Debian с Copilot CLI, Codex и Pi, а доступ по SSH, RDP и Docker включается флагами.

CLIРасширенный доступ154

Containarium — изолированные машины для ИИ-агентов

Containarium

Официальный

Платформа на вашем сервере, которая выдает каждому агенту свою Linux-машину с SSH и MCP-инструментами для команд и файлов

MCP-серверШирокий доступ316

AgentBox

AgentBox запускает Claude Code, Codex и Open Code в отдельных виртуальных машинах: на вашем ПК, своем сервере или в облаке.

CLIРасширенный доступ570

Agent Toolkit for AWS