Sandbox as a Service

sandbox-as-a-service-mcp

エージェントに、自由に壊せる本物の Linux 仮想マシンを提供する MCP サーバーです。

11 個のツールを備えています。サンドボックスの作成、シェルコマンドの実行、ファイルの書き込みと読み取り、実行によって生成されたものの一覧表示、公開プレビュー URL でのポート公開、有効期間の延長、サンドボックスの破棄、利用料金の確認ができます。

各サンドボックスは独自のカーネルを持つ専用 VM です。他のユーザーのコードとホストを共有するコンテナではありません。アカウント間で再利用されることはなく、期限が切れると、誰かが破棄を忘れていても破棄されます。

利用方法

Sandbox as a Service の運営者がメンテナンスしています。

ホスト型 MCP（ローカルパッケージ不要）

Streamable HTTP に対応したクライアントでは、次の宛先に接続してください。

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

リクエストごとに、独自の API キーを Authorization: Bearer <your-api-key> または x-api-key: <your-api-key> として送信してください。API キーは ダッシュボード → API キー で取得できます。 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	権限のないユーザーとしてシェルコマンドを実行します。標準出力、標準エラー、終了コードを返します。
write_file	ファイルを書き込みます。内容は別経路で送信されるため、引用符やバイナリもそのまま扱えます。
read_file	ファイルを読み取ります。エージェントはこれを使って、コードが生成したものを確認できます。
list_files	ディレクトリツリーを一覧表示し、実行によって生成されたものをエージェントが見つけられるようにします。
expose_port	サンドボックス内のサーバーに、共有可能な公開 HTTPS URL を割り当てます。
get_sandbox	状態、サイズ、有効期限を確認します。
list_sandboxes	アカウント内のすべてのサンドボックスを、新しい順に一覧表示します。残っているサンドボックスを探すのに便利です。
extend_sandbox	ジョブがタイムアウトを超える場合に、有効期限を延長します。
destroy_sandbox	サンドボックスを破棄し、課金を停止します。
get_usage	残りのクレジットと最近の利用状況を確認します。

エージェント向けの注意事項

• コードは権限のないユーザーとして実行されます。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 にあります。 ドキュメント。