asif-nvc/e2b-sandbox-mcp

asif-nvc/e2b-sandbox-mcp

от asif-nvc
MCP-сервер, подключающий Claude Code к облачным Linux-сандбоксам E2B для работы с GitHub-репозиториями (клон, команды, файлы, git) безопасно, не затрагивая локальную машину.

E2B Sandbox MCP Server

npm version license

An MCP (Model Context Protocol) server that connects Claude Code with E2B cloud sandboxes, giving you isolated Linux VMs to work on any GitHub repository without touching your local machine.

What It Does

This server provides Claude Code with 29 tools to create cloud sandboxes, clone repos, run commands, manage files, and perform git operations — all in a secure, disposable Linux environment.

Your local machine stays untouched. Every operation happens inside an E2B sandbox VM.

Token Savings

Running commands through E2B sandboxes instead of local Bash reduces the tokens consumed per conversation. Tool outputs are structured and truncated (100KB per stream, 200KB total), so large build/test outputs don't flood your context window.

Project Size Example Local Bash Tokens E2B Sandbox Tokens Savings
Small Express API, ~10 files ~15K-25K ~10K-18K ~20-30%
Medium Next.js app, 50-100 files ~50K-100K ~25K-45K ~40-55%
Large Monorepo, 500+ files ~200K-500K+ ~60K-120K ~60-75%

Why it scales: A local npm install on a monorepo can dump 10K+ lines into context. A full test suite adds thousands more. With E2B, those outputs are capped and structured. Background processes (sandbox_exec_background) return only a process ID — zero streaming output. Directory listings are capped at 1000 entries. The result: your context window stays available for actual work instead of being consumed by terminal noise.

Инструменты были проиндексированы:
sandbox_create

Создаёт новую облачную песочницу E2B (изолированная Linux-ВМ) и возвращает её sandboxId для использования со всеми остальными инструментами sandbox_*. Это точка входа — вызывайте этот инструмент перед любой другой операцией с песочницей. Песочница автоматически истекает после тайм-аута (по умолчанию 5 минут); используйте sandbox_keep_alive для продления или sandbox_pause, чтобы сохранить её бессрочно. Если установлен GITHUB_TOKEN, аутентификация git настраивается автоматически для доступа к приватным репозиториям. Возвращает sandboxId, templateId, метку времени создания, метаданные и статус аутентификации git. Расходует квоту API E2B (проверьте лимиты на e2b.dev/pricing).

Параметры
  • metadataobject

    Key-value labels for identifying the sandbox later (e.g., {"repo": "user/project", "purpose": "testing"}). Returned by sandbox_list and sandbox_info.

  • templateIdstring

    Sandbox template ID (e.g., "base", "python", or a custom template). Defaults to "base" (Ubuntu with common tools). Use a custom template for pre-installed languages, databases, or project dependencies.

  • timeoutMsnumber

    Auto-expiry timeout in milliseconds. Default: 300000 (5 min). Max: 86400000 (24h on Pro plan). After this, the sandbox is destroyed and all data is lost. Use sandbox_keep_alive to extend or sandbox_pause to preserve state.

sandbox_download_url

Генерирует временный предварительно подписанный URL для загрузки файла из песочницы (только чтение, без побочных эффектов). Используйте его, чтобы получить артефакты сборки, логи, бинарные файлы или любой другой файл из песочницы на локальную машину. URL можно открыть в браузере или загрузить с помощью curl/wget. URL истекает через короткий промежуток времени. Для чтения содержимого файла напрямую как текст используйте sandbox_file_read, он возвращает содержимое inline. В отличие от sandbox_upload_url (который отправляет файлы в песочницу), этот получает файлы из неё. Завершается ошибкой, если указанный путь к файлу не существует.

Параметры
  • pathstringобязательный

    Absolute path to the file inside the sandbox to download (e.g., "/home/user/repo/dist/bundle.js"). Must be a file, not a directory. Use sandbox_file_list to find available files.

  • sandboxIdstringобязательный

    The sandbox ID containing the file.

sandbox_exec

Выполняет shell-команду в песочнице и ожидает её завершения. Возвращает stdout, stderr и код возврата. Изменяет файловую систему и состояние песочницы в зависимости от команды (например, "npm install" добавляет node_modules, "rm -rf" удаляет файлы). Вывод обрезается до 100 КБ на поток (stdout/stderr), чтобы избежать переполнения контекста. Используйте этот инструмент для команд, которые завершаются быстро (сборки, тесты, установки, скрипты). Для долгоживущих процессов, таких как dev-серверы или watcher'ы, используйте sandbox_exec_background вместо этого — sandbox_exec будет блокировать выполнение до выхода команды или истечения таймаута. Если срок действия песочницы истёк, возвращает ошибку и удаляет её из реестра.

Параметры
  • commandstringобязательный

    The shell command to execute (e.g., "npm install", "python main.py", "ls -la"). Runs in bash. Supports pipes, redirects, and chaining with && or ;.

  • cwdstring

    Working directory inside the sandbox. Defaults to "/home/user". Use the path returned by sandbox_git_clone to run commands in a cloned repository.

  • envsobject

    Environment variables to set for this command only (e.g., {"NODE_ENV": "production", "DEBUG": "true"}). These do not persist across calls.

  • sandboxIdstringобязательный

    The sandbox ID to run the command in. Must be an active sandbox.

  • timeoutMsnumber

    Command timeout in milliseconds. Default: 120000 (2 min). The command is killed if it exceeds this. Set higher for long builds (e.g., 600000 for 10 min). Set 0 for no timeout (use with caution).

sandbox_exec_background

Запускает долговременный фоновый процесс в изолированной среде (например, dev-сервер, наблюдатель за файлами, база данных) и сразу возвращает его PID. Не ждёт завершения команды и не передаёт вывод потоком — используйте этот инструмент для процессов, работающих бесконечно. Процесс продолжает выполняться, пока изолированная среда не истечёт, не будет завершён с помощью sandbox_process_kill или не завершится сам. Используйте sandbox_process_list, чтобы проверить, работает ли он ещё. Для доступа к веб-серверу, запущенному таким образом, используйте sandbox_get_url с номером порта. В отличие от sandbox_exec (который блокирует выполнение до завершения), этот инструмент возвращает управление сразу.

Параметры
  • commandstringобязательный

    The shell command to run in the background (e.g., "npm run dev", "python -m http.server 8080", "redis-server"). The process will keep running after this tool returns.

  • cwdstring

    Working directory for the process. Defaults to "/home/user". Use the cloned repo path for running dev servers.

  • envsobject

    Environment variables for this process (e.g., {"PORT": "3000"}). These do not affect other commands.

  • sandboxIdstringобязательный

    The sandbox ID to run the process in. Must be an active sandbox.

sandbox_file_exists

Проверяет, существует ли файл или директория по заданному пути в песочнице (только чтение, без побочных эффектов). Возвращает {path, exists: true/false} — никогда не выбрасывает ошибку для несуществующих путей. Используйте это перед sandbox_file_read, sandbox_file_remove или sandbox_file_info, чтобы избежать ошибок при отсутствии путей. В отличие от sandbox_file_info (который завершается ошибкой, если путь не существует), этот безопасно возвращает false. В отличие от sandbox_file_list (который выводит содержимое директории), этот проверяет один конкретный путь.

Параметры
  • pathstringобязательный

    Absolute path to check for existence (e.g., "/home/user/repo/package.json"). Can be a file or directory path.

  • sandboxIdstringобязательный

    The sandbox ID to check in.

sandbox_file_info

Получает метаданные о файле или директории в песочнице (только чтение, без побочных эффектов). Возвращает тип файла (файл или директория), размер в байтах и права доступа. Используйте это, чтобы проверить размер файла перед чтением, убедиться в типе файла или проверить права доступа. Завершается ошибкой, если путь не существует — сначала используйте sandbox_file_exists, если не уверены. В отличие от sandbox_file_read (возвращает содержимое файла) или sandbox_file_list (перечисляет записи директории), этот инструмент возвращает метаданные для одного пути.

Параметры
  • pathstringобязательный

    Absolute path to inspect (e.g., "/home/user/repo/package.json"). Can be a file or directory.

  • sandboxIdstringобязательный

    The sandbox ID containing the file or directory.

sandbox_file_list

Перечисляет файлы и каталоги в песочнице (только чтение, без побочных эффектов). Возвращает записи, помеченные как [FILE] или [DIR], вместе с их именами. Ограничивает результаты 1000 записей для больших каталогов. Используется для изучения файловой системы песочницы, поиска файлов после клонирования репозитория или проверки создания файлов. Завершается ошибкой, если путь не существует или не является каталогом. В отличие от sandbox_file_read (возвращает содержимое файла) или sandbox_file_info (возвращает метаданные для одного пути), этот инструмент перечисляет содержимое каталога.

Параметры
  • pathstring

    Absolute path to a directory inside the sandbox (e.g., "/home/user/repo/src"). Defaults to "/home/user". Must be a directory, not a file.

  • sandboxIdstringобязательный

    The sandbox ID to list files in.

sandbox_file_mkdir

Создаёт каталог (и все отсутствующие родительские каталоги) в песочнице. Бесшумно завершается успешно, если каталог уже существует. Используйте это для настройки структуры каталогов перед записью файлов с помощью sandbox_file_write или перед загрузкой через sandbox_upload_url. В отличие от sandbox_file_write (который создаёт файлы), этот инструмент создаёт пустые каталоги. В отличие от sandbox_file_remove (который удаляет), этот только создаёт.

Параметры
  • pathstringобязательный

    Absolute path of the directory to create (e.g., "/home/user/repo/src/components"). All intermediate directories are created if they do not exist.

  • sandboxIdstringобязательный

    The sandbox ID to create the directory in.

sandbox_file_read

Читает полное текстовое содержимое файла в sandbox и возвращает его встроенно (только для чтения, без побочных эффектов). Для больших файлов вывод обрезается до 200 КБ. Используйте для просмотра исходного кода, конфигурационных файлов, логов или любого текстового файла. Для бинарных файлов или очень больших файлов используйте sandbox_download_url вместо этого, чтобы получить ссылку для скачивания. Завершается ошибкой, если файл не существует или путь указывает на каталог. В отличие от sandbox_file_info (который возвращает только метаданные) или sandbox_file_list (который выводит содержимое каталога), этот инструмент возвращает фактическое содержимое файла.

Параметры
  • pathstringобязательный

    Absolute path to the file inside the sandbox (e.g., "/home/user/repo/src/index.ts"). Must be a file, not a directory. Use sandbox_file_list to discover file paths.

  • sandboxIdstringобязательный

    The sandbox ID containing the file.

sandbox_file_remove

Навсегда и необратимо удаляет файл или каталог в песочнице. Каталоги удаляются рекурсивно, включая всё содержимое. Это действие нельзя отменить: нет корзины. Завершается ошибкой, если путь не существует. Используйте sandbox_file_exists, чтобы проверить перед удалением, если не уверены. В отличие от sandbox_exec с "rm", этот инструмент предоставляет структурированные отчеты об ошибках. Для перемещения файлов вместо удаления используйте sandbox_file_rename.

Параметры
  • pathstringобязательный

    Absolute path of the file or directory to delete (e.g., "/home/user/repo/old-file.txt"). Must exist or the operation will fail.

  • sandboxIdstringобязательный

    The sandbox ID containing the file or directory.

sandbox_file_rename

Переименовывает или перемещает файл или каталог внутри песочницы. Исходный путь должен существовать; конечный путь не должен уже существовать. Работает как с файлами, так и с каталогами. Используйте это для реорганизации структуры проекта или переименования файлов. Возвращает старый путь, новый путь и тип записи. В отличие от sandbox_file_remove (который удаляет навсегда), этот сохраняет файл и изменяет его местоположение или имя. В отличие от sandbox_file_write (который создает/перезаписывает содержимое), этот только изменяет путь.

Параметры
  • newPathstringобязательный

    New absolute path for the file or directory (e.g., "/home/user/repo/new-name.ts"). Parent directory must exist — use sandbox_file_mkdir first if needed.

  • oldPathstringобязательный

    Current absolute path of the file or directory to rename/move (e.g., "/home/user/repo/old-name.ts"). Must exist.

  • sandboxIdstringобязательный

    The sandbox ID containing the file or directory.

sandbox_file_write

Записывает текстовое содержимое в файл в песочнице. Создаёт файл, если его не существует, и полностью перезаписывает его, если он существует. Режима добавления нет. Родительские каталоги создаются автоматически. Возвращает путь к файлу и количество записанных байт. Используйте это для создания или замены исходного кода, файлов конфигурации, скриптов или любого текстового содержимого. Для загрузки бинарных файлов с локальной машины вместо этого используйте sandbox_upload_url. В отличие от sandbox_file_rename (который перемещает файлы) или sandbox_file_remove (который удаляет файлы), этот инструмент создаёт или заменяет содержимое файла.

Параметры
  • contentstringобязательный

    The full text content to write to the file. This replaces any existing content entirely. For large binary files, use sandbox_upload_url instead.

  • pathstringобязательный

    Absolute path for the file (e.g., "/home/user/repo/src/app.ts"). If the file exists, it will be completely overwritten. Parent directories are created automatically.

  • sandboxIdstringобязательный

    The sandbox ID to write the file in.

sandbox_get_url

Получает публичный HTTPS URL для доступа к сервису, запущенному на определённом порту внутри песочницы (только чтение, без побочных эффектов). Используйте этот инструмент после запуска dev-сервера или веб-приложения с помощью sandbox_exec_background, чтобы просмотреть его в браузере. URL общедоступен — любой, у кого есть ссылка, может получить доступ к сервису. Возвращает полный URL, хост и порт. Сервис уже должен прослушивать указанный порт; этот инструмент не запускает никакой сервис. В отличие от sandbox_upload_url/sandbox_download_url (для передачи файлов), этот инструмент предоставляет прямой доступ к работающим HTTP-сервисам.

Параметры
  • portnumberобязательный

    The port number the service is listening on inside the sandbox (e.g., 3000 for React/Next.js, 8080 for Express, 5173 for Vite). The service must already be running.

  • sandboxIdstringобязательный

    The sandbox ID running the service.

sandbox_git_branch

Управляет ветками git в изолированном репозитории: перечисляет существующие ветки, создает новую ветку или переключается на другую ветку. Действие "list" только для чтения. Действие "create" создает новую ветку от текущего HEAD, но не переключается на неё. Действие "checkout" переключает рабочую директорию на указанную ветку, изменяя файлы на месте - любые незакоммиченные изменения могут привести к конфликту. Требует branchName для действий "create" и "checkout". В отличие от sandbox_git_status (который показывает текущую ветку и изменения в файлах), этот инструмент управляет жизненным циклом веток. В отличие от sandbox_git_commit или sandbox_git_push, этот инструмент не влияет на историю коммитов.

Параметры
  • actionenumобязательный

    The branch operation: "list" shows all local branches (read-only), "create" creates a new branch from current HEAD (does not switch to it), "checkout" switches the working directory to the specified branch (modifies files).

  • branchNamestring

    Branch name for "create" or "checkout" actions (e.g., "feature/new-login"). Required for "create" and "checkout", ignored for "list". For "create", the name must not already exist. For "checkout", the branch must exist.

  • repoPathstringобязательный

    Absolute path to the git repository (e.g., "/home/user/repo"). Must be a valid git repository.

  • sandboxIdstringобязательный

    The sandbox ID containing the repository.

sandbox_git_clone

Клонирует git-репозиторий в песочницу, загружая его файлы и историю. Обычно это первый шаг после sandbox_create: клонировать репозиторий, затем использовать sandbox_exec для сборки/тестирования. Создаёт новый каталог по целевому пути, содержащий репозиторий. Поддерживает как публичные, так и приватные репозитории (для приватных требуется настроить GITHUB_TOKEN). По умолчанию поверхностное клонирование (depth=1) загружает только последний коммит для ускорения. Изменяет файловую систему песочницы, создавая каталог клона и записывая все файлы репозитория. Завершается ошибкой, если целевой путь уже существует или URL репозитория недействителен. В отличие от sandbox_git_pull (который обновляет существующий репозиторий), этот инструмент выполняет начальную загрузку.

Параметры
  • branchstring

    Specific branch to clone. Defaults to the repository's default branch (usually "main" or "master"). Use this to clone a feature branch or PR branch directly.

  • depthnumber

    Shallow clone depth (number of commits). Default: 1 (latest commit only, fastest). Set 0 for full history (needed for git log, blame, or bisect). Values like 10 or 50 provide partial history.

  • pathstring

    Destination path for the cloned repository. Defaults to "/home/user/repo". The directory must not already exist. Use this path in subsequent sandbox_exec and sandbox_git_* calls.

  • repoUrlstringобязательный

    Git repository URL (e.g., "https://github.com/user/repo"). HTTPS URLs only. For private repos, GITHUB_TOKEN must be configured at server startup.

  • sandboxIdstringобязательный

    The sandbox ID to clone into. Must be an active sandbox created with sandbox_create.

sandbox_git_commit

Индексирует файлы и создаёт git-коммит в изолированном репозитории. Это двухшаговая операция: сначала индексирует указанные файлы (или все изменения, если файлы не указаны), затем создаёт коммит с заданным сообщением. Изменяет историю git — коммит добавляется в текущую ветку. Сначала используйте sandbox_git_status, чтобы увидеть доступные для коммита изменения. После создания коммита используйте sandbox_git_push, чтобы отправить его в удалённый репозиторий. Завершается ошибкой, если нет изменений для коммита или если путь не является git-репозиторием. В отличие от sandbox_git_push (который отправляет коммиты), этот инструмент только создаёт локальный коммит.

Параметры
  • authorEmailstring

    Git commit author email. If omitted, uses the repository's configured user.email or defaults.

  • authorNamestring

    Git commit author name. If omitted, uses the repository's configured user.name or defaults.

  • filesstring[]

    Specific file paths to stage, relative to repoPath (e.g., ["src/index.ts", "package.json"]). If omitted, stages all modified, added, and deleted files (equivalent to "git add -A").

  • messagestringобязательный

    Commit message describing the changes. Should be concise and descriptive (e.g., "Fix login validation bug").

  • repoPathstringобязательный

    Absolute path to the git repository (e.g., "/home/user/repo"). Must be a valid git repository.

  • sandboxIdstringобязательный

    The sandbox ID containing the repository.

sandbox_git_init

Инициализирует новый пустой git-репозиторий в директории песочницы. Создаёт директорию .git по указанному пути, позволяя выполнять операции git (commit, branch и т. д.) с файлами в этой директории. Используйте это, когда начинаете новый проект с нуля — не требуется, если вы использовали sandbox_git_clone (он уже инициализирует git). Директория уже должна существовать; при необходимости сначала используйте sandbox_file_mkdir. Не создаёт начальный коммит. В отличие от sandbox_git_clone (который загружает существующий репозиторий), этот инструмент создаёт новый, пустой репозиторий.

Параметры
  • pathstringобязательный

    Absolute path to the directory where the git repository should be initialized (e.g., "/home/user/my-project"). The directory must already exist. A .git subdirectory will be created inside it.

  • sandboxIdstringобязательный

    The sandbox ID to initialize the repository in.

sandbox_git_pull

Извлекает и сливает последние изменения из удалённого репозитория в текущую ветку песочного репозитория. Изменяет рабочую директорию и может вызвать конфликты слияния, если локальные изменения пересекаются с удалёнными. Требует предварительно клонированный репозиторий (сначала используйте sandbox_git_clone). В отличие от sandbox_git_clone (первоначальная загрузка) или sandbox_git_push (отправка изменений), этот инструмент обновляет существующий локальный репозиторий удалёнными изменениями. Возвращает удалённый репозиторий и ветку, которые были стянуты. Завершается ошибкой, если путь не является git-репозиторием или удалённый репозиторий недоступен.

Параметры
  • branchstring

    Branch to pull. Defaults to the currently checked-out branch. Use sandbox_git_branch with action "list" to see available branches.

  • remotestring

    Remote name to pull from. Defaults to "origin". Use sandbox_git_branch to verify available remotes.

  • repoPathstringобязательный

    Absolute path to an existing git repository in the sandbox (e.g., "/home/user/repo"). Must already be initialized via sandbox_git_clone or sandbox_git_init.

  • sandboxIdstringобязательный

    The sandbox ID containing the repository.

sandbox_git_push

Отправляет локальные коммиты в удаленный репозиторий. Это деструктивная внешняя операция — коммиты становятся видимыми для других и их нельзя легко отменить. Требует, чтобы GITHUB_TOKEN был настроен при запуске сервера; немедленно завершается с четкой ошибкой, если токен не задан. Сначала используйте sandbox_git_commit для создания локальных коммитов, затем отправляйте. Для новых веток установите setUpstream в true. В отличие от sandbox_git_pull (который загружает удаленные изменения) или sandbox_git_commit (который только создает локальные коммиты), эта операция загружает коммиты на удаленный сервер. Завершается ошибкой, если нет коммитов для отправки или удаленный репозиторий недоступен.

Параметры
  • branchstring

    Branch name to push. Defaults to the currently checked-out branch. Must match a local branch with commits.

  • remotestring

    Remote name to push to. Defaults to "origin". Most repositories only have one remote.

  • repoPathstringобязательный

    Absolute path to the git repository (e.g., "/home/user/repo"). Must have at least one commit to push.

  • sandboxIdstringобязательный

    The sandbox ID containing the repository.

  • setUpstreamboolean

    Set upstream tracking reference. Set to true when pushing a newly created branch for the first time (equivalent to "git push -u"). Not needed for branches that already track a remote.

sandbox_git_status

Получает текущий статус git репозитория в песочнице (только чтение, без побочных эффектов). Возвращает имя текущей ветки, список изменённых файлов, файлов в индексе и неотслеживаемых файлов. Используйте этот инструмент перед sandbox_git_commit, чтобы увидеть, что будет закоммичено, или после sandbox_file_write, чтобы проверить, что изменения обнаружены. В отличие от sandbox_git_branch (который управляет ветками) или sandbox_git_commit (который создаёт коммиты), этот инструмент только просматривает текущее состояние. Завершается ошибкой, если путь не является git-репозиторием.

Параметры
  • repoPathstringобязательный

    Absolute path to the git repository in the sandbox (e.g., "/home/user/repo"). Must be a directory initialized with sandbox_git_clone or sandbox_git_init.

  • sandboxIdstringобязательный

    The sandbox ID containing the repository.

sandbox_info

Получает подробные метаданные о конкретной песочнице (только чтение, без побочных эффектов). Возвращает ID песочницы, ID шаблона, временную метку создания и любые пользовательские метки метаданных. Используйте этот инструмент для просмотра одной песочницы по ID. В отличие от sandbox_list (который возвращает сводку всех активных песочниц), этот инструмент предоставляет полные детали для одной песочницы. Завершается ошибкой, если ID песочницы не найден в реестре активных.

Параметры
  • sandboxIdstringобязательный

    The sandbox ID to inspect. Must be an active sandbox returned by sandbox_create or sandbox_list. Use sandbox_list first if you do not know the ID.

sandbox_keep_alive

Продлевает тайм-аут автоматического завершения активной песочницы, чтобы предотвратить автоматическое завершение (без других побочных эффектов). Новый тайм-аут начинается с текущего момента, а не с момента создания. Используйте это, когда песочница скоро истечёт, но она всё ещё нужна. Для бессрочного продления используйте sandbox_pause. Завершается ошибкой, если идентификатор песочницы не найден. Возвращает подтверждение с новой длительностью тайм-аута.

Параметры
  • sandboxIdstringобязательный

    The sandbox ID to extend. Must be an active (not paused or killed) sandbox.

  • timeoutMsnumberобязательный

    New timeout in milliseconds from now (e.g., 300000 for 5 min, 3600000 for 1 hour). The sandbox will auto-terminate after this duration unless extended again.

sandbox_kill

Навсегда завершает и уничтожает песочницу, включая все файлы, процессы и состояние. Это необратимо: все данные в песочнице теряются. Вместо этого используйте sandbox_pause, если хотите сохранить состояние для последующего использования. Чтобы сохранить файлы перед уничтожением, сначала используйте sandbox_download_url или sandbox_file_read. Вызов завершается ошибкой, если идентификатор песочницы не найден. После уничтожения sandboxId становится недействительным для любых операций.

Параметры
  • sandboxIdstringобязательный

    The sandbox ID to terminate. Must be an active sandbox from sandbox_create or sandbox_list.

sandbox_list

Перечисляет все активные песочницы E2B, управляемые этим сервером (только чтение, без побочных эффектов). Возвращает массив сводок по песочницам, включая sandboxId, templateId, время создания и метаданные для каждой. Возвращает пустое сообщение, если песочниц не существует. Используйте это, чтобы найти ID песочниц, если вы потеряли их из виду. В отличие от sandbox_info (которая возвращает полные сведения для одной песочницы), этот инструмент возвращает сводку по всем песочницам. Не включает приостановленные песочницы: их нужно возобновить с помощью sandbox_resume, используя их исходный sandboxId.

Параметры

Без параметров.

sandbox_pause

Приостанавливает активную песочницу, чтобы сохранить её полное состояние (файловую систему, установленные пакеты, конфигурацию) для последующего возобновления. Песочница удаляется из активного реестра, и отсчёт её тайм-аута останавливается. Возобновите её позже с помощью sandbox_resume, используя тот же sandboxId — даже в разных сессиях. В отличие от sandbox_kill (которая всё уничтожает), pause сохраняет состояние. Работающие процессы могут не пережить приостановку/возобновление. Используйте это для длительных сессий разработки, когда хотите продолжить позже. Завершается ошибкой, если идентификатор песочницы не найден.

Параметры
  • sandboxIdstringобязательный

    The sandbox ID to pause. Must be an active sandbox. Save the returned sandboxId to resume later with sandbox_resume.

sandbox_process_kill

Завершает запущенный процесс в песочнице по его PID. Процесс останавливается немедленно и не подлежит возобновлению. Сначала используйте sandbox_process_list, чтобы найти PID нужного процесса. Обычное применение: остановка dev-сервера, запущенного с помощью sandbox_exec_background, перед запуском нового на том же порту. Возвращает успех, если процесс найден и завершен, или ошибку, если PID не существует. В отличие от sandbox_kill (который уничтожает всю песочницу), этот инструмент останавливает только один процесс.

Параметры
  • pidnumberобязательный

    Process ID to kill. Obtain PIDs by calling sandbox_process_list first. Using an incorrect PID returns an error.

  • sandboxIdstringобязательный

    The sandbox ID containing the process. Must be an active sandbox.

sandbox_process_list

Выводит список всех запущенных процессов в песочнице (только для чтения, без побочных эффектов). Возвращает PID, имя команды, аргументы и тег для каждого процесса. Используйте этот инструмент, чтобы найти PID фонового процесса, запущенного с помощью sandbox_exec_background, чтобы затем завершить его через sandbox_process_kill, или чтобы проверить, что процесс ещё работает. Возвращает пустое сообщение, если нет активных процессов. В отличие от sandbox_exec (который запускает новую команду), этот инструмент проверяет то, что уже выполняется.

Параметры
  • sandboxIdstringобязательный

    The sandbox ID to inspect. Must be an active sandbox.

sandbox_resume

Возобновляет ранее приостановленную песочницу, восстанавливая её файловую систему и состояние. Песочница снова становится активной с новым таймаутом и повторно добавляется в активный реестр. Если настроен GITHUB_TOKEN, аутентификация git автоматически восстанавливается. Работает только с песочницами, приостановленными через sandbox_pause — не с убитыми или истёкшими. После возобновления используйте все остальные инструменты sandbox_* как обычно. Завершается ошибкой, если sandboxId не соответствует приостановленной песочнице.

Параметры
  • sandboxIdstringобязательный

    The sandbox ID of the paused sandbox to resume. This is the same ID returned by sandbox_create and sandbox_pause.

  • timeoutMsnumber

    New auto-expiry timeout in milliseconds after resuming. Default: 300000 (5 min). Use sandbox_keep_alive to extend later if needed.

sandbox_upload_url

Генерирует временную предварительно подписанную ссылку для загрузки файла в sandbox (только для чтения, без побочных эффектов в sandbox, пока ссылка не будет использована). Возвращаемая ссылка принимает POST-запрос с файлом в формате multipart/form-data. Ссылка истекает через короткий промежуток времени. Используйте её для передачи локальных файлов в sandbox; для прямой записи текстового содержимого используйте sandbox_file_write. В отличие от sandbox_download_url (которая получает файлы из sandbox), эта ссылка загружает файлы в него.

Параметры
  • pathstring

    Destination directory path inside the sandbox where the uploaded file will be placed. Defaults to "/home/user". The directory must exist — use sandbox_file_mkdir to create it first if needed.

  • sandboxIdstringобязательный

    The sandbox ID to upload the file to.

Похожие MCP-сервера

babelcloud/gru-sandbox

babelcloud/gru-sandbox

GBOX - MCP сервер, дающий ИИ-агентам возможность управлять Android и Linux окружениями для тестирования и автоматизации. Подключается к Claude Code, Cursor и другим агентам через MCP, расширяя их возможности.

Go181
helbertparanhos/easypanel-mcp-server

helbertparanhos/easypanel-mcp-server

MCP-сервер, который даёт Claude полный контроль над Easypanel: деплой из GitHub, управление переменными окружения, логи, домены, базы данных и контейнеры — 57 инструментов плюс raw-доступ ко всем п...

TypeScript2
adhikasp/mcp-git-ingest

adhikasp/mcp-git-ingest

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

Python314
ofershap/mcp-server-docker

ofershap/mcp-server-docker

MCP-сервер для управления Docker из AI-ассистента: просмотр контейнеров, логов, запуск/остановка, выполнение команд и мониторинг ресурсов. Подключается к локальному Docker без API-ключей. Полезен р...

TypeScript2
hyperb1iss/droidmind

hyperb1iss/droidmind

DroidMind связывает AI-ассистентов с Android-устройствами через MCP. Управляйте приложениями, анализируйте логи, автоматизируйте UI и выполняйте shell-команды на естественном языке. Полезен разрабо...

Python431
apireno/DOMShell

apireno/DOMShell

DOMShell превращает браузер в виртуальную файловую систему: AI-агенты и разработчики управляют веб-страницами через Linux-команды (ls, cd, cat, click). Упрощает автоматизацию, тестирование и веб-ск...

TypeScript52
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин