sandbox-mcp CLI
CLI sbx и MCP-сервер запускают приложение агента в чистой Windows Sandbox и возвращают отчет со скриншотами и сбоями
- 411 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент запускает приложения, установщики и непроверенные файлы в песочнице, а режимы сети `firewall` и `on` открывают гостю доступ наружу.
- Включение Windows Sandbox требует прав администратора и перезагрузки.
Установка
- Работает в
Ручная установка
Set up the sandbox-mcp CLI by following: https://raw.githubusercontent.com/shanselman/sandbox-mcp/main/docs/agent-setup.md Install the latest verified release. The CLI must work without MCP; configure the optional MCP adapter only if my agent needs it. Ask before admin changes or a restart.
Промпт из README: агент проверяет компьютер, сверяет контрольную сумму релиза и спрашивает перед правами администратора.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент запускает приложения, установщики и непроверенные файлы в песочнице, а режимы сети `firewall` и `on` открывают гостю доступ наружу.
- Включение Windows Sandbox требует прав администратора и перезагрузки.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
sandbox-mcp дает агенту одноразовый компьютер с Windows 11 на базе встроенной Windows Sandbox. Команда `sbx run` поднимает чистую гостевую систему, разворачивает в ней приложение, запускает его, собирает скриншоты и события сбоев, а потом уничтожает машину. Типичный прогон GUI-приложения занимает 40–50 секунд. Отчет показывает то, что прячет машина разработчика: например, приложение падает на чистой системе из-за отсутствующего распространяемого пакета Visual C++. Зависимости ставятся только по явному флагу `--provision auto`. Агент также умеет кликать по элементам интерфейса через UI Automation и записывать прогон в видео. `sbx install-test` сравнивает систему до установки и после удаления и показывает, что осталось. `sbx detonate` запускает подозрительный файл без сети и перечисляет его процессы, соединения и изменения. Те же действия доступны как инструменты MCP, а в папке `skills/` лежат скиллы под каждый сценарий.
Для кого. Разработчикам настольных приложений под Windows, которые проверяют сборки, установщики и подозрительные файлы с помощью агента.
Подходит, если
- Приложение работает на машине разработчика, а у клиента не запускается, и причину надо найти на чистой Windows.
- Агент собрал WPF или WinForms приложение, и нужно проверить интерфейс кликами и скриншотом.
- Установщик подозревают в мусоре после удаления, и нужен список оставшихся файлов, ключей реестра и служб.
- Пришел незнакомый скрипт или исполняемый файл, и хочется увидеть его поведение без доступа к своей системе.
Не подходит, если
- У вас Windows Home, Windows Server, macOS или Linux: Windows Sandbox там недоступна.
- Нужно гонять несколько изолированных машин параллельно.
- Требуется проверка приложений из Microsoft Store или с зависимостями через winget.
Пример запроса к агенту
Собери приложение, запусти его в свежей Windows Sandbox без сети, введи мое имя в поле, нажми Greet и покажи скриншот.Ограничения
Нужна Windows 11 24H2 (сборка 26100) или новее в редакции Pro, Enterprise или Education с включенным компонентом Windows Sandbox и вошедшим пользователем. Одновременно работает только одна песочница, повторный запуск сразу завершается ошибкой. Внутри гостя нет Microsoft Store, winget, Блокнота и Калькулятора, есть Windows PowerShell 5.1 и .NET Framework 4.8. Снимок системы для проверки установщика занимает 10–20 секунд, весь прогон около двух минут. Готовые пакеты собраны только для x64, ARM64 пока не поддерживается.
Как отключить. Удалите папку с распакованным архивом или выполните `npm unlink` в клоне. Уберите сервер `windows-sandbox` из настроек MCP, отчеты лежат в `%LOCALAPPDATA%\sandbox-mcp\runs`.
Частые вопросы
Нужен ли MCP-сервер, чтобы агент работал с sandbox-mcp?
Нет. Если агент умеет запускать команды, ему хватает `sbx`. MCP-адаптер пригодится клиентам, которым удобны схемы инструментов и картинки прямо в ответе.
Как включить Windows Sandbox?
В PowerShell от администратора выполните `Enable-WindowsOptionalFeature -Online -FeatureName Containers-DisposableClientVM -All` и перезагрузите Windows. Затем один раз откройте Windows Sandbox из меню Пуск и запустите `sbx doctor`.
Ставит ли sbx зависимости в гостевую систему сам?
Нет, по умолчанию ничего не ставится. Команда `sbx deps` показывает недостающие компоненты. Установка идет только с флагом `--provision auto`.
Где лежат отчеты прогонов?
В `%LOCALAPPDATA%\sandbox-mcp\runs\<время>`: `report.md`, `report.json`, скриншоты и журнал `audit.jsonl`. Корень меняет переменная `SANDBOX_MCP_HOME`.
Как подключить его к Claude Desktop?
Добавьте в `mcpServers` сервер `windows-sandbox` с полным путем к `node.exe` и `src\server.js` из распакованного архива. Поля `type` и `tools` для Claude Desktop не нужны.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP-сервер и CLI дают агенту собственный скрытый рабочий стол Linux с X11 или Wayland, не трогая ваш экран и браузер
BrowserStack MCP Server — тесты на реальных устройствах
BrowserStack MCP Server
Официальный MCP-сервер BrowserStack: реальные устройства, автотесты и тест-кейсы под управлением агента из редактора
sunpeak тестирует любой MCP-сервер в локальных копиях сред ChatGPT и Claude и собирает MCP-приложения на React
kogiQA MCP дает агенту браузер, который находит элементы страницы без селекторов, для отладки веб-приложений и e2e-тестов
MCP-сервер отладки Electron: 111 инструментов, чтобы агент видел окно, нажимал кнопки, читал консоль и сеть и проверял защиту.
CLI, MCP-сервер и типизированный Node.js API, чтобы агент проверял свои правки в живом мобильном приложении на iOS, Android и других платформах
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| sandbox-mcp (эта карточка) | нет | 411 | ||
| Windows-MCP | нет | не нужна | 11 574 | управляет вашим рабочим столом Windows; здесь агент работает в одноразовой чистой машине и уничтожает ее после прогона |
| AIO Sandbox | нет | ключ необязателен | 6 331 | песочница в контейнере Linux с браузером и терминалом; здесь настоящая Windows 11 для настольных приложений |
Коротко о README
README начинается с промпта для самостоятельной установки агентом и примера пойманной ошибки на чистой системе. Дальше идут сравнение с виртуальными машинами и контейнерами, включение Windows Sandbox, таблица команд CLI и инструментов MCP, режимы сети и ограничения.