Docker Sandbox

🚀 砂箱 MCP サーバー

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

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

🚀 クイックスタート

✨ 主な機能

• 任意の 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 を使用してコンテナに直接アクセスする
• コンテナを停止および起動する
• 不要になったらコンテナを削除する

コンテナ状態の保存

環境を設定した後、その状態を Docker イメージとして保存することができます。

現在のコンテナ状態を 'my-ds-env:v1' という名前のイメージとして保存してくれますか？

これにより、以下のことが行われます。

1. 以下の内容を含む新しい Docker イメージを作成する
   • インストールされたパッケージ
   • 作成されたファイル
   • 設定変更
2. 環境を再利用する方法を説明する

その後、このイメージを共有したり、新しいコンテナを作成するための起点として使用することができます。

'my-ds-env:v1' イメージを使用して新しいコンテナを作成してくれますか？

Dockerfile のエクスポート

環境を完全に再現可能にするために、Dockerfile を生成することができます。

この環境を再構築する Dockerfile をエクスポートしてくれますか？

生成される Dockerfile には、以下の内容が含まれます。

• ベースイメージの指定
• 作成されたファイル
• 追加の設定手順のテンプレート

この Dockerfile を使用して、以下のことができます。

1. 他のユーザーと環境設定を共有する
2. 環境をバージョン管理する
3. ビルドプロセスを変更およびカスタマイズする
4. 異なるシステムにデプロイする

推奨ツール

1. create_container_environment：指定されたイメージの新しい Docker コンテナを作成する
2. create_file_in_container：コンテナ内にファイルを作成する
3. execute_command_in_container：コンテナ内でコマンドを実行する
4. save_container_state：コンテナの状態を永続的なコンテナに保存する
5. export_dockerfile：永続的な環境を作成するための Docker ファイルをエクスポートする
6. exit_container：コンテナを閉じて環境をクリーンアップする