SandboxX MCP
Uses Docker to create and manage a restricted Linux sandbox container for executing shell commands, preserving workspace state between calls, enforcing timeouts and resource limits, and exporting files as tar.gz archives.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
SandboxX MCP
MCP-сервер для запуска и тестирования кода в ограниченном Linux-контейнере. Поддерживает Streamable HTTP на endpoint /mcp и один инструмент shell с сохранением рабочей директории между вызовами.
Возможности
Фоновый запуск и повторное использование контейнера.
Автоматический перезапуск контейнера после сбоя и остановка вместе с сервером.
Таймауты команд, ограничение вывода, памяти, CPU и числа процессов.
Непривилегированный пользователь, сброшенные Linux capabilities и
no-new-privileges.Структурированный результат вызова и понятные ошибки Docker.
Защита MCP от DNS rebinding и настраиваемые
Host/Originдля LAN.
Related MCP server: devbox-mcp
Требования
Python 3.11 или новее.
Запущенный Docker Desktop или Docker daemon.
uvдля рекомендуемого способа установки.
Установка и запуск
Соберите образ песочницы:
docker build -t my-mcp-sandbox .Установите зависимости:
uv syncЗапустите сервер:
uv run main.pyПо умолчанию endpoint доступен только на локальной машине:
http://127.0.0.1:7070/mcpТакже доступны консольная команда и явные параметры адреса:
uv run mcp-dev -H 127.0.0.1 -p 7071
# или
python main.py -H 127.0.0.1 -p 7071Для установки без uv:
pip install -r requirements.txt
python main.pyВсе параметры запуска:
uv run main.py --helpПодключение MCP-клиента
{
"mcpServers": {
"SandboxX": {
"url": "http://127.0.0.1:7070/mcp",
"startupTimeoutMs": 30000,
"toolTimeoutMs": 615000
}
}
}Сначала запустите сервер через uv run main.py, затем создайте новую сессию Kimi Code. Проверить подключение можно командой /mcp. toolTimeoutMs должен покрывать максимальный таймаут команды и время принудительного завершения процессов.
Запуск в локальной сети
Можно слушать конкретный LAN-адрес — он автоматически добавляется в разрешённые Host:
uv run main.py -H 192.168.31.27 -p 7070При прослушивании всех интерфейсов укажите адрес, который клиенты будут передавать в Host:
uv run main.py \
-H 0.0.0.0 \
--allowed-host '192.168.31.27:*'Для браузерного клиента с другого origin добавьте:
--allowed-origin 'http://192.168.31.27:8080'Оба параметра можно повторять. Не публикуйте сервер в интернете без внешней аутентификации: аутентификация MCP-клиентов здесь не настроена.
Инструмент shell
Выполняет команду через sh -c в /workspace. Файлы и установленные в окружение пакеты сохраняются между вызовами, пока работает сервер. После остановки сервера контейнер и его рабочая директория удаляются.
Аргументы:
command— обязательная непустая shell-команда.timeout— необязательный таймаут в секундах, от 1 до 600. По умолчанию 30 секунд; для установки пакетов и сборок — 600.
Пример вызова:
{
"command": "python --version && echo 'print(2 + 2)' > example.py && python example.py",
"timeout": 30
}Результат:
{
"exit_code": 0,
"output": "Python 3.x.x\n4\n",
"timed_out": false,
"truncated": false
}stdout и stderr объединены. При таймауте возвращается exit_code: 124 и timed_out: true; при ошибке запуска команды или Docker — exit_code: -1. Слишком длинный вывод обрезается, а truncated становится true.
Инструмент export
Упаковывает файл или директорию из контейнера в tar.gz и возвращает архив как бинарный MCP-ресурс с MIME-типом application/gzip. Относительные пути разрешаются от /workspace.
Аргументы:
path— путь к файлу или директории, по умолчанию/workspace.timeout— необязательный таймаут от 1 до 600 секунд, по умолчанию 120.
Пример вызова:
{
"path": "/workspace",
"timeout": 120
}Текстовая часть результата содержит имя и размер архива, а structuredContent — поля archive_name, source, size_bytes и mime_type. Само содержимое передаётся в EmbeddedResource, поэтому поддерживающий бинарные ресурсы клиент может сохранить его как .tar.gz. Максимальный размер сжатого архива — 50 МиБ. Архив создаётся от пользователя sandbox с соблюдением его прав доступа.
Настройка через окружение
Переменная | По умолчанию | Назначение |
|
| Имя Docker-образа |
|
| Пользователь внутри контейнера |
|
| Обычный таймаут, секунды |
|
| Таймаут сборок и установки пакетов, секунды |
|
| Таймаут экспорта, секунды |
|
| Максимально разрешённый таймаут, секунды |
|
| Максимальное число символов вывода |
|
| Максимальный размер сжатого архива в байтах |
|
| Лимит памяти контейнера |
|
| Лимит CPU |
|
| Максимальное число процессов |
|
| Таймаут обращения к Docker API, секунды |
Образ песочницы
В Alpine-образ входят Python с виртуальным окружением, Node.js/npm, Go, Rust/Cargo, Git и компиляторы C/C++. Команды выполняются от пользователя sandbox; системные пакеты Alpine через apk add ему недоступны. Python-пакеты устанавливаются в преднастроенное окружение:
pip install requestsКонтейнер изолирован на уровне Docker, но не является границей безопасности для враждебных multi-tenant нагрузок. Доступ к Docker socket хоста не предоставляется, privileged-режим отключён.
Устранение неполадок
Docker недоступен— запустите Docker Desktop/daemon и повторите вызов. Сам MCP-сервер при этом продолжает работать. На macOS стандартный socket~/.docker/run/docker.sockопределяется автоматически; для другого адреса задайте стандартную переменнуюDOCKER_HOST.Образ 'my-mcp-sandbox' не найден— выполнитеdocker build -t my-mcp-sandbox .из корня проекта.HTTP 421 — добавьте используемый клиентом адрес через
--allowed-host, а браузерный origin через--allowed-origin.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Start, pause, resume, and run commands and file operations in Linux sandboxes.
Secure Linux sandboxes for AI agents, as MCP tools.
MCP server for Superserve sandboxes: create, exec, and manage Firecracker microVMs
Create a free sandbox object storage bucket; upload, download, list, inspect, and delete objects.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to operate a persistent Linux sandbox in the cloud, running commands, managing files, using Git, and publishing artifacts through a Streamable HTTP MCP endpoint.-
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to execute shell commands, manage long-running processes, and read/write files on the host machine with the permissions of the user running the server.5 npmMIT
- FlicenseNot gradedqualityBmaintenanceEnables agents and MCP clients to safely execute and verify multi-language code in a deterministic sandbox, using AST security analysis to block dangerous system calls and capture isolated execution telemetry.7-
- AlicenseAqualityCmaintenanceEnables MCP clients to start and control Owner-approved local POSIX subprocess sessions over stdio, with cursor-based output reads, input writes, status checks, termination, and resource/time limits.5MIT