ScratchRun

@scratchrun/mcp-server

ScratchRun 用の MCP サーバーです。AI エージェント向けに、使い捨てで MicroVM によって分離されたコード実行を提供します。

呼び出しごとに、新しいハードウェア分離された MicroVM で実行されます。実行後、VM は完全に消去されます。呼び出し間で状態やファイルなどが保持されることはありません。

インストール

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "scratchrun": {
      "command": "npx",
      "args": ["-y", "@scratchrun/mcp-server"],
      "env": {
        "SCRATCHRUN_API_KEY": "sr_live_your_key_here"
      }
    }
  }
}

scratchrun.dev で API キーを取得してください。

ツール：scratchrun_exec

使い捨てのサンドボックスでコードを実行し、stdout、stderr、終了コード、および出力ファイルを返します。

パラメーター：

パラメーター	型	必須	説明
runtime	python3.12 | python3.11 | node20 | bash	はい	使用するランタイム
code	string	はい	実行するコード
timeout_ms	integer	いいえ	タイムアウト（ミリ秒）（デフォルト 10000、最大 30000）
memory_mb	integer	いいえ	メモリ上限（MB）（デフォルト 256、最大 512）
env	object	いいえ	環境変数。コード文字列ではなく、シークレットに使用します
files	object	いいえ	実行前に書き込むファイル（パス → 内容）
return_files	string[]	いいえ	実行後に取得するファイルパス（base64 で返されます）

例 — Python を実行してグラフを返す：

{
  "runtime": "python3.12",
  "code": "import matplotlib.pyplot as plt\nimport numpy as np\nx = np.linspace(0, 10, 100)\nplt.plot(x, np.sin(x))\nplt.savefig('/tmp/plot.png')",
  "return_files": ["/tmp/plot.png"]
}

出力ファイルは base64 で返されます。画像ファイル（PNG、JPG、SVG）は MCP の画像コンテンツブロックとして返され、Claude 内にインライン表示されます。

分離

• 実行ごとにハードウェア仮想化された MicroVM を使用します（独自のカーネルを持ち、カーネルを共有するコンテナーではありません）
• 実行のたびに必ず TerminateMicroVM が呼び出され、VM は破棄され、再利用されません
• RFC 1918 およびクラウドメタデータ（169.254.x.x）は、ネットワーク層で常にブロックされます
• OverlayFS を介した読み取り専用のシステムファイルシステムを使用します。/tmp は RAM 上にあり、VM とともに消去されます

レイテンシー

約 400ms（ウォームプール利用時の中央値）。プールが空の場合、コールドスタートに 2～8 秒かかります。

ライセンス

MIT