Sandbox as a Service

sandbox-as-a-service-mcp

一个 MCP 服务，为 Agent 提供一台可以随意折腾的真实 Linux 虚拟机。

提供 11 个工具：创建沙盒、在沙盒中运行 Shell 命令、写入和读取文件、列出运行生成的内容、将端口映射到公开预览 URL、延长使用期限、销毁沙盒，以及查看费用。

每个沙盒都是一台专用 VM，拥有自己的内核，而不是与他人的代码共享主机的容器。沙盒不会在不同账户之间重复使用，并会在到期时销毁，无论是否有人记得提出销毁请求。

使用方法

由 Sandbox as a Service 的运营方维护。

托管 MCP（无需本地安装包）

对于支持 Streamable HTTP 的客户端，请连接到：

https://sandbox-as-a-service.com/v1/mcp

在每个请求中，通过 Authorization: Bearer <your-api-key> 或 x-api-key: <your-api-key> 发送自己的 API 密钥。请前往 Dashboard → API keys 获取。 切勿将 API 密钥放入 URL，也不要通过注册表分享密钥。

托管服务提供 12 个工具：下面的 11 个账户/执行工具，以及 get_service_info。匿名调用 initialize、tools/list 和 get_service_info，即可免费发现托管服务；账户和执行请求仍需要提供密钥。本地 stdio 服务（包括当前可下载的 mcp.tgz v1.1.0）提供 11 个账户/执行工具。需要免密查看服务信息时，请使用托管端点。仅使用 GET 的检查不算连接测试：此端点使用 MCP POST 请求和 SSE 响应。

在 Smithery 上，将 apiKey 设置为你自己的原始密钥；它会映射到 x-api-key 标头。 连接文档。

本地 stdio（当前托管安装包）

AAS_API_KEY=aas_sk_... npx -y https://sandbox-as-a-service.com/mcp.tgz

请前往 sandbox-as-a-service.com 获取密钥——新账户会获得免费额度，无需绑定银行卡。

Claude Desktop / Claude Code

{
  "mcpServers": {
    "sandbox": {
      "command": "npx",
      "args": ["-y", "https://sandbox-as-a-service.com/mcp.tgz"],
      "env": { "AAS_API_KEY": "aas_sk_..." }
    }
  }
}

工具

工具	功能
create_sandbox	创建 VM，并在其就绪后返回 ID。
run_command	以非特权用户身份运行 Shell 命令。返回 stdout、stderr 和退出码。
write_file	写入文件。内容通过带外方式传输，因此引号和二进制内容都能保留。
read_file	读取文件——Agent 借此获取代码生成内容。
list_files	列出目录树，方便 Agent 查找运行生成的内容。
expose_port	为沙盒内的服务提供公开 https URL，供他人访问。
get_sandbox	查看状态、规格和到期时间。
list_sandboxes	列出账户中的所有沙盒，最新的排在最前——便于查找遗留沙盒。
extend_sandbox	当任务超出超时时间时，延长沙盒的到期时间。
destroy_sandbox	销毁沙盒并停止计费。
get_usage	查看剩余额度和近期用量。

给 Agent 的说明

• 代码以非特权用户身份运行。没有 sudo，因此 apt-get 无法使用；请使用 pip install --user --break-system-packages 或 npm install，这两种方式都可行。
• run_command 会等待命令执行完毕。请使用 & 启动服务，否则该调用会一直保持打开状态，直到超时。
• 沙盒会在超时后销毁，无论是否调用 destroy_sandbox，因此忘记销毁沙盒只会多花几分钟，而不会一直产生费用。即便如此，调用该工具也能返还原本用不上的剩余分钟数。

环境变量

变量
AAS_API_KEY	必填。你的 API 密钥。
AAS_BASE_URL	可选。默认为 https://sandbox-as-a-service.com。仅使用源站地址，不要包含 /v1；客户端会添加该 API 前缀。

采用 MIT 许可证。该服务的地址为 sandbox-as-a-service.com； 文档。