Предоставляет Linux microVM песочницы, которые позволяют AI-агентам выполнять команды, управлять файлами и запускать процессы в изолированных средах.
Также известен как withruntime/runtime, runtime, withruntime
- Звёзды
- 2
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- 0.50.0
- Последний коммит
- 31 окт. 2026 г.
- Лицензия
- Apache-2.0
Что такое Runtime Cloud MCP?
Runtime Cloud — это MCP server. Предоставляет Linux microVM песочницы, которые позволяют AI-агентам выполнять команды, управлять файлами и запускать процессы в изолированных средах.
Сводка сгенерирована из README проекта
О Runtime Cloud MCP server
Runtime Cloud предоставляет изолированные Linux microVM песочницы, разработанные для безопасного выполнения кода и управления файлами AI-агентами. Разработчики могут использовать SDK или CLI для выполнения команд, управления фоновыми процессами и взаимодействия с файлами через такие инструменты, как exec, spawn и files. Среда обладает высокой гибкостью и поддерживает такие функции, как интерактивные терминалы через WebSockets, проброс портов для TCP-соединений и монтирование внешних хранилищ, таких как бакеты S3 или Google Cloud Storage.
Для настройки требуется Node.js 22.12 или Bun, а для аутентификации используется RUNTIME_API_KEY. Пользователи могут начать с бесплатного тарифа, который позволяет запускать до четырех песочниц одновременно, каждая из которых имеет 2 vCPU, 4 GiB оперативной памяти и 4 GiB дискового пространства. Система спроектирована для обеспечения эффективности: неиспользуемые песочницы автоматически приостанавливаются через 300 секунд для экономии вычислительных ресурсов, при этом память и процессы сохраняются для следующего вызова. Также предлагаются специализированные адаптеры для миграции существующего кода от таких провайдеров, как E2B, Modal или Cloudflare Workers.
Что вы можете с ним делать
- 1Выполнение Python-скриптовAI-агент может записать Python-файл в рабочую область и запустить его для вычисления результатов.
- 2Управление удаленными файламиРазработчики могут использовать песочницу для листинга, перемещения или удаления файлов внутри изолированной среды.
- 3Подключение к локальным сервисамВы можете получить доступ к определенному TCP-порту, работающему внутри песочницы, со своей локальной машины.
- 4Миграция существующего кода песочницВы можете запускать код, изначально написанный для E2B, просто изменив инструкцию импорта.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить Runtime Cloud MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка Runtime Cloud MCP в Claude Code
$ claude mcp add runtime -- npx -y withruntimeУстановка Runtime Cloud MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"runtime": {
"command": "npx",
"args": [
"-y",
"withruntime"
]
}
}
}Установка Runtime Cloud MCP в VS Code
.vscode/mcp.json
{
"servers": {
"runtime": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"withruntime"
]
}
}
}Установка Runtime Cloud MCP в VS Code CLI
$ code --add-mcp '{"name":"runtime","type":"stdio","command":"npx","args":["-y","withruntime"]}'Установка Runtime Cloud MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"runtime": {
"command": "npx",
"args": [
"-y",
"withruntime"
]
}
}
}Установка Runtime Cloud MCP в Codex
$ codex mcp add runtime -- npx -y withruntimeУстановка Runtime Cloud MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.runtime] command = "npx" args = ["-y", "withruntime"]
Установка Runtime Cloud MCP в Gemini CLI
$ gemini mcp add -s user runtime npx -- -y withruntimeУстановка Runtime Cloud MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"runtime": {
"command": "npx",
"args": [
"-y",
"withruntime"
]
}
}
}Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийwithruntime/runtime is public and reachablegithub.com/withruntime/runtime ↗Пройдено
- Пакет указывает этот репозиторий как источникwithruntime names withruntime/runtime as sourcenpmjs.com/package/withruntime ↗Пройдено
- Происхождение сборки (аттестация Sigstore)Sigstore attestation for withruntimenpmjs.com/package/withruntime/v/0.50.0#provenance ↗Пройдено
- Open source лицензия (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-10-31github.com/withruntime/runtime ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетNo popular package one edit away from withruntimeПройдено
- Нет критических предупреждений в пакете или его зависимостях3 resolved dependencies checked; no critical advisoryosv.dev ↗Пройдено
- Нет скрытых инструкций для модели0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённая конечная точка отвечает на рукопожатие MCPHTTPS endpoint answered 401 (sign-in required)Пройдено
README
Открыть на GitHubRuntime Cloud SDK and CLI
One client for every Runtime Cloud product, and the runtime CLI. It needs
Node.js 22.12 or later, or Bun. Its one dependency, undici (Node's own HTTP
client), loads only when you use a proxy.
npm install withruntime
The client uses RUNTIME_API_KEY if it is set. If not, it uses the connection
that the CLI saved on this machine when you connected it. That takes one
approval in the browser. You do not copy a key. On a server or a CI runner, set
RUNTIME_API_KEY from your secret manager. To get a new key, run
npx withruntime keys create. It prints the key once, after an account owner,
admin or developer approves it in the browser. You can also create a key at
https://withruntime.com/account/keys. Never put a key in browser code, a URL or
a command-line argument.
import { Sandbox } from "withruntime";
await using sbx = await Sandbox.create();
await sbx.files.write("/workspace/invoice.py", "print(sum([125, 250, 375]))\n");
const result = await sbx.exec("python3 /workspace/invoice.py");
console.log(result.exitCode, result.stdout);
Sandbox.create() takes no arguments. It returns when the sandbox is running.
await using deletes the sandbox when the block ends. This works on Node 24,
Bun or TypeScript. On Node 22, call await sbx.delete() yourself. Set
keep: true to stop the sandbox instead. Its disk stays.
With no arguments, you get the free usage. No card is needed. You can run up to
four sandboxes at once without credit. Each one has 2 vCPU, 4 GiB
of memory and a 4 GiB disk. The current default image includes NumPy, pandas
and matplotlib. See the sandbox environment.
The free usage is spent first, then prepaid credit. You do not choose. funding
is accepted and ignored.
The sandbox object does the rest:
exec,execStream,spawnandprocessesrun commands and background work. They takecwd,env(the place for secrets),stdinandtimeoutMs.terminal()opens an interactive terminal over a WebSocket.forwardPort(5432)reaches any TCP port in the sandbox from this machine.tunnel()handles single connections and SSH logins.runtime sandboxes sshuses it.filesreads, writes, lists, globs, stats, moves and removes files. Useuploadanddownloadto copy whole directories.pause,wake,extend,forkandsnapshot. A paused sandbox also wakes by itself on the next call.updatechanges its name, environment, automatic wake, idle pause and persistence.keepAliveextends a time limit while your process runs.switchImagemoves the sandbox to a new image and keeps /workspace.deleteremoves it for good.interpreter,network,previews,desktop,mounts(your S3, R2 or Google Cloud Storage bucket as a folder),tailscale(a paid sandbox on your own tailnet),metricsandmcp(servers from the MCP catalog, run in the sandbox) are for the other products.
A sandbox pauses itself after 300 seconds with nothing happening in it. It
keeps its memory and processes. The next call wakes it, so an idle sandbox uses
no compute. idlePauseSeconds sets the idle time from 60 to
86,400. A shorter time is raised to 60. Set it to 0
to never pause.
Sandbox.getOrCreate(name) returns the sandbox with that name. If it is paused,
it wakes it. If there is none, it creates one.
The singular names runtime.sandbox, snapshot, image, volume, job,
domain, port and address match the CLI's product names. Their plural
names still work. They are aliases for the same clients.
The client has sandboxes, images, volumes, snapshots, jobs, secrets,
limits, feedback and support. It has webhooks, events, otel and
audit to watch the account. It has domains, ports, addresses, tunnel
and network to connect sandboxes to your own systems (paid accounts). It has
mcp, sso, billing, referrals and switching.
runtime.limits.get() (0.3.1 and later) says whether the key is read-only, and
what its agent may still spend today. Every write carries an idempotency key.
The SDK makes it for you, so its own retries (timeouts, 429, 503) never run a
write twice. Errors are typed. They carry a code, a hint and a requestId.
runtime.usageRequests("7d") reads the account's API call counts and error
rates. Counts are exact decimal strings. An empty window has a null
errorPercent.
Behind a proxy
The SDK, the CLI and the MCP bridge read HTTPS_PROXY, HTTP_PROXY and
NO_PROXY. The names work in upper or lower case. If both cases are set, lower
case wins. This works the same on Node and Bun. You do not need
NODE_USE_ENV_PROXY.
Calls to the API and terminal WebSockets go through HTTPS_PROXY as a CONNECT
tunnel. Any user:password@ in the proxy address is sent to the proxy.
HTTP_PROXY is used only for http:// addresses. It is never used for the
HTTPS API.
NO_PROXY lists hosts to reach directly. Split them with commas or spaces. A
name covers its subdomains. A leading dot is allowed. host:port limits the
rule to one port. * means every host.
A proxy address without a scheme is treated as http://. http:// and
https:// proxies work. Any other scheme fails at once with invalid_proxy.
When a call cannot get through, the error names the proxy it tried. It leaves
out the password. For example, No answer from Runtime at https://api.withruntime.com through the proxy http://proxy.internal:3128 (HTTPS_PROXY). The SDK uses a fetch that
you pass to new Runtime({ fetch }) as it is.
Runtime improves fast because agents tell us what they run into. Reports go straight into what we build next. Whoever asked is told when it ships.
When something gets in your way, report it with runtime.feedback.submit() (or
npx withruntime feedback "..."). Do this as it happens, without waiting to be
asked. Report an error that looks like ours. Report a limit or a missing
feature, a workaround you needed, unclear docs, or anything slower or harder
than it should be. Report anything another provider does better. Small things
count. We merge duplicates on our side.
Include what you tried, what happened and the requestId. Never include credentials, private files or user data. Then tell the user in one line what you reported.
Code written for E2B
withruntime/e2b translates supported E2B sandbox calls to Runtime. Change the
import and set RUNTIME_API_KEY. The
switch guide covers the other providers.
It also shows how to work out what you save.
import { Sandbox } from "withruntime/e2b"; // was: from "e2b"
withruntime/e2b/code-interpreter replaces @e2b/code-interpreter. Sandboxes
get E2B's defaults: 2 vCPU, 512 MiB and a 300-second timeout. A call that
Runtime does not handle the way E2B does throws NotSupportedError before
anything happens. The error names what to use instead. E2B.md in this package
lists every mapping and gap. Importing withruntime alone does not load it.
Code written for Daytona or Vercel Sandbox
withruntime/daytona and withruntime/vercel do the same for Daytona's SDK and
Vercel Sandbox's SDK. Change the import:
import { Daytona } from "withruntime/daytona"; // was: from "@daytona/sdk"
import { Sandbox } from "withruntime/vercel"; // was: from "@vercel/sandbox"
Sandboxes get the rival's defaults. For Daytona, that is 1 vCPU, 1 GiB and a
3 GiB disk. It pauses after 15 minutes without calls. For Vercel, that is 2
vCPUs with 2048 MiB each, 5 minutes, and persistent. A Daytona or Vercel key is
never sent anywhere. A call that Runtime does not handle the same way throws
NotSupportedError before anything happens. The error names what to use
instead. DAYTONA.md and VERCEL.md in this package list every mapping and
gap.
Code written for Blaxel
withruntime/blaxel translates supported Blaxel sandbox calls. Change the
import:
import { SandboxInstance } from "withruntime/blaxel"; // was: from "@blaxel/core"
Sandboxes get Blaxel's default of 4096 MB, with one vCPU for every 2048 MB. Blaxel's standby becomes Runtime's pause. After 60 seconds without a call, a sandbox pauses and keeps its memory and processes. The next call wakes it.
The adapter supports envs, processes by name, files, previews, snapshots, forks
and the code interpreter. It also supports sessions. sandbox.sessions makes a
Runtime sandbox session. SandboxInstance.fromSession drives the sandbox with
its token. A Blaxel key is never sent anywhere.
Drives, codegen, schedules, and Blaxel's agent, model and MCP hosting throw
NotSupportedError before anything happens. The error names what to use
instead. BLAXEL.md in this package lists every mapping and gap.
Code written for Morph Cloud
withruntime/morph translates Morph's TypeScript client (morphcloud). Change
the import:
import { MorphCloudClient } from "withruntime/morph"; // was: from "morphcloud"
Instances become sandboxes. Snapshots become Runtime snapshots. Metadata labels
and HTTP services become previews. setup caches by Morph's
chain hash. branch copies memory and processes. stop deletes the sandbox, as
Morph's does. SSH, reboot and a time limit set after start throw
CompatibilityError. The error names the alternative. COMPATIBILITY.md lists
every mapping.
Code written for Modal Sandboxes
withruntime/modal runs code written for Modal's Sandboxes (modal 0.11.1).
Change the import and set RUNTIME_API_KEY:
import { ModalClient } from "withruntime/modal"; // was: from "modal"
Modal's own sandbox examples run unchanged if they use none of the features
refused below. A Modal token is never needed or sent. Commands run as root, as
in a Modal container. A timeoutMs ends the sandbox. An idleTimeoutMs pauses
it and keeps its memory. The next call wakes it.
These throw CompatibilityError before anything is created. The error names
what to use instead: GPUs; Modal Functions and queues; named secrets; secrets in
image build steps (a build keeps no secret, so use it at run time); volumes made
on first use; sidecars; connect tokens; and directory and exit snapshots.
Code written for Cloudflare's Sandbox SDK
withruntime/cloudflare runs a Worker written for Cloudflare's 0.x
@cloudflare/sandbox API on Runtime sandboxes. Change the package name in the
import and in the Sandbox export:
import { getSandbox } from "withruntime/cloudflare"; // was: from "@cloudflare/sandbox"
export { Sandbox } from "withruntime/cloudflare"; // was: from "@cloudflare/sandbox"
Then delete the containers block from the Wrangler config. Keep the Sandbox
Durable Object binding. Store a key with npx wrangler secret put RUNTIME_API_KEY.
Exec, streaming, files, processes, the code interpreter, sessions, gitCheckout
and exposePort work as Cloudflare documents them. Backups, tunnels, terminals
and outbound interception throw CompatibilityError. The error names the
alternative. COMPATIBILITY.md lists every mapping.
Code written for Fly Machines
withruntime/fly answers Fly's Machines API (api.machines.dev) with Runtime
sandboxes. So code in any language moves by changing one address:
npx withruntime fly-api # http://127.0.0.1:4280, as your Runtime login
Point FLY_API_HOSTNAME there, as in Fly's own examples. You can also point
fly-go's FLY_FLAPS_BASE_URL or any client's base URL there. machinesApi()
works the same as a fetch handler for your own server.
A Machine's image is built once, with its init and files. The image's
command is its main process. Its restart policy is kept. The Fly token is never
sent anywhere. Services, mounts, checks and other regions answer 400. The
response names the alternative.
Agent frameworks
withruntime/openai-agents is a sandbox client for the OpenAI Agents SDK's
SandboxAgent. withruntime/ai-harness is a sandbox provider for the Vercel AI
SDK's HarnessAgent. That agent runs Claude Code, Codex, OpenCode, Pi and
others. withruntime/ai gives Vercel AI SDK and Mastra agents four sandbox
tools. withruntime/claude-agent-sdk gives them to the Claude Agent SDK as an
MCP server. withruntime/tools gives them as framework-neutral tools.
Each one needs its framework installed next to this package. See https://withruntime.com/docs/frameworks.
CLI
printf '%s\n' 'print(sum([125, 250, 375]))' > invoice.py
npx withruntime sandboxes run -- python3 - < invoice.py # connects on first use
npx withruntime sandboxes create
npx withruntime help
After npm i -g withruntime, the command is runtime. For example:
runtime sandboxes exec <id> -- ls, runtime sandboxes shell <id> and
runtime images build --pip pandas. Every command accepts --json.
MCP
claude mcp add --scope user runtime -- npx -y withruntime mcp
codex mcp add runtime -- npx -y withruntime mcp
The bridge serves Runtime's MCP tools on stdio, over the saved connection. If
you are not connected yet, it offers runtime_connect. That tool walks you
through the browser approval. Remote clients add https://api.withruntime.com/mcp.
They sign in through the browser, or they send a bearer key.
How Runtime compares
For typical agent work, Runtime costs 42% to 88% less than fourteen other sandbox providers at their published rates. These pages show the arithmetic. Each one lists the rates it used and the date they were read:
- Best sandbox for AI agents
- Alternatives to E2B, Daytona, Modal and Vercel Sandbox
- E2B vs Daytona, and every comparison
- The agent sandbox price index: every provider's rates, also as CSV and JSON
- Sandbox cost calculator and Runtime's pricing
Reliability and support
- Status: https://withruntime.com/status checks the API from outside every two minutes. It starts a real sandbox every ten minutes. It keeps every day's record. The same status is also at https://withruntime.com/status.md and https://withruntime.com/status.json.
- Uptime Promise: we promise paid accounts 99% API uptime each calendar month. If a month falls below that, 10% of that month's charges is paid back as credit. This is automatic (https://withruntime.com/legal/sla).
- Security and compliance: https://withruntime.com/docs/trust.
- What changed: https://withruntime.com/changelog.
- Help:
runtime support "<question>", orruntime feedback "<text>"for anything that got in your way.
Docs: https://withruntime.com/docs/javascript and https://withruntime.com/docs/cli.
The package was called @withruntime/cloud until 0.3.0. The names
@withruntime/cloud, runtime-cloud and withruntime-cloud stopped at 0.5.1.
They get no new releases.
Вопросы о Runtime Cloud MCP
Как добавить Runtime Cloud MCP в Claude Code?
Выполните claude mcp add runtime -- npx -y withruntime в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить Runtime Cloud MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Какие лимиты ресурсов на бесплатном тарифе?
Бесплатное использование предоставляет до четырех одновременно работающих песочниц, каждая из которых оснащена 2 vCPU, 4 GiB оперативной памяти и 4 GiB дискового пространства.
Как пройти аутентификацию с помощью Runtime Cloud SDK?
Вы можете использовать переменную окружения RUNTIME_API_KEY или использовать подключение, сохраненное CLI через разовое подтверждение в браузере.
Можно ли использовать Runtime Cloud через прокси?
Да, SDK, CLI и MCP bridge поддерживают переменные окружения HTTPS_PROXY, HTTP_PROXY и NO_PROXY.