Sandbox MCP Server

🚀 砂箱 MCP サーバー

このサーバーは、コード実行用の隔離された Docker 環境を提供する MCP サーバーです。以下のことが可能です：

• 任意の Docker イメージを使用してコンテナを作成する
• 複数のプログラミング言語でコードを記述し、実行する
• パッケージをインストールし、開発環境を設定する
• 隔離されたコンテナ内でコマンドを実行する

🚀 クイックスタート

前提条件

• Python 3.9 以上
• インストール済みで実行中の Docker
• uv パッケージマネージャー（推奨）
• Docker MCP サーバー（推奨）

📦 インストール

1. このリポジトリをクローンします：

git clone <your-repo-url>
cd sandbox_server

2. uv を使用して仮想環境を作成し、アクティブ化します：

uv venv
source .venv/bin/activate  # Unix/MacOS の場合
# または Windows の場合：
# .venv\Scripts\activate

3. 依存関係をインストールします：

uv pip install .

Claude Desktop との統合

1. Claude Desktop の設定ファイルを開きます：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json%

2. サンドボックスサーバーの設定を追加します：

{
    "mcpServers": {
        "sandbox": {
            "command": "uv",
            "args": [
                "--directory",
                "/absolute/path/to/sandbox_server",
                "run",
                "sandbox_server.py"
            ],
            "env": {
                "PYTHONPATH": "/absolute/path/to/sandbox_server"
            }
        }
    }
}

/absolute/path/to/sandbox_server を実際のプロジェクトディレクトリのパスに置き換えてください。

3. Claude Desktop を再起動します。

💻 使用例

基本的な使用法

Claude Desktop に接続すると、以下のことができます：

1. Python コンテナを作成する：

Python コンテナを作成し、簡単な「こんにちは、世界」プログラムを記述できますか？

2. 異なる言語でコードを実行する：

フィボナッチ数列を計算する C プログラムを作成して実行できますか？

3. パッケージをインストールして使用する：

numpy を使用してランダムデータを生成し、描画する Python スクリプトを作成できますか？

開発環境の保存と再現

このサーバーは、開発環境を保存して再現するためのいくつかの方法を提供します：

永続化コンテナの作成

コンテナを作成する際に、永続化するように設定することができます：

numpy と pandas がインストールされた永続化 Python コンテナを作成できますか？

これにより、以下の特性を持つコンテナが作成されます：

• Claude Desktop を閉じても実行され続ける
• Docker を通じて直接アクセスできる
• インストールされたすべてのパッケージとファイルを保持する

サーバーは以下の指示を提供します：

• docker exec を使用して直接コンテナにアクセスする
• コンテナの停止と起動
• 不要になったときに削除する

コンテナの状態を保存する

コンテナの状態を永続化コンテナに保存できますか？

Dockerfile をエクスポートする

永続化環境を作成するための Dockerfile をエクスポートできますか？

コンテナを終了する

コンテナを閉じて環境をクリーンアップできますか？

🔒 セキュリティに関する注意事項

• 外部コマンドを実行する際は、信頼できるソースを使用するようにしてください。
• 信頼できない環境でユーザーが提供したコードを実行しないでください。

🏗️ プロジェクト構造

（原文でこのセクションに具体的な内容がなかったため、そのまま表示）