Sandbox MCP

🚀 砂箱 MCP 紹介

砂箱 MCP は、モデルコンテキストプロトコル（MCP）サーバーで、大規模言語モデル（LLM、つまり MCP ホスト/クライアント）が 安全に隔離された Docker コンテナ内でコードを実行 できるようにします。

LLM はコード生成能力に優れていますが、ほとんどの場合 生成したコードを実行することができません。このため、未テストのコードを直接マシン上で実行すると、深刻な問題を引き起こす可能性があります。

LLM に安全にコードをテストする能力を与えることで、このような問題を防ぎ、より正確なコードをより迅速に生成 するのに役立ちます。

砂箱 MCP は、LLM に 使いやすい実行環境を提供し、誰でも簡単で AI ネイティブな MCP サーバーを使ってローカルで作成および構成 することができます。

• Codapi からインスピレーションを得ています。一部の砂箱は Codapi 砂箱 と同じです。

🚀 クイックスタート

デモ

このデモでは、砂箱 MCP が Claude Desktop と一緒にどのように動作するかを示しています。

GIF が見えにくい場合は、動画 demo.mp4 をご覧ください。

インストール

バイナリファイルのダウンロード

リリースページ から、お使いのオペレーティングシステム（例：Darwin）とプロセッサアーキテクチャ（例：arm64）に適したバイナリファイル（例：sandbox-mcp_Darwin_arm64.tar.gz）をダウンロードできます。

Go を使用したインストール

前提条件：

• Go 1.24 以上

go install github.com/pottekkat/sandbox-mcp/cmd/sandbox-mcp@latest

sandbox-mcp バイナリファイルのパスを取得するには：

which sandbox-mcp

ソースコードからのビルド

開発部分 を参照してください。

使用方法

初期化

sandbox-mcp を LLM と一緒に使用する前に、その設定を初期化する必要があります。

# 設定ディレクトリ $XDG_CONFIG_HOME/sandbox-mcp を作成し、GitHub からデフォルトの砂箱を取得
sandbox-mcp --pull

# 砂箱の Docker イメージをビルド
sandbox-mcp --build

⚠️ 重要提示

Docker がインストールされ、実行されていることを確認してください。

MCP ホスト/クライアントとの使用

claude_desktop_config.json（Claude Desktop 用）または mcp.json（Cursor IDE 用）に以下の内容を追加します。

{
    "mcpServers": {
        "sandbox-mcp": {
            "command": "path/to/sandbox-mcp",
            "args": [
                "--stdio"
            ]
        }
    }
}

⚠️ 重要提示

path/to/sandbox-mcp を実際の sandbox-mcp バイナリファイルのパスに置き換えてください。

✨ 主な機能

利用可能な砂箱

shell

厳格なセキュリティとネットワーク制限のある Linux 環境で shell コマンドを実行します。

python

特定のライブラリが事前にインストールされた環境で Python コードを実行します。

⚠️ 重要提示

カスタム砂箱を作成して、Go、Java、SQL などの他の言語やツールをサポートすることができます。

network_tools

制限されたネットワーク環境で安全にネットワーク関連のタスクを実行します。

🔧 開発

# リポジトリをフォークし、プロジェクトディレクトリに移動
git clone https://github.com/pottekkat/sandbox-mcp.git && cd sandbox-mcp

# 依存関係をインストール
npm install

# Docker イメージをビルド（`docker/` ディレクトリにあります）
docker build -t sandbox-mcp .

# テストを実行
npm test

砂箱 MCP は、LLM が生成したコードを安全に実行するための信頼性の高い方法を提供し、開発者や一般ユーザーにとって一定の価値があります。