MCP Sandbox

🚀 MCP Sandbox環境構築と使用ガイド

MCP SandboxはPythonベースのサンドボックス環境ツールで、安全に隔離された環境でPythonコードを実行するために使用されます。Dockerコンテナ技術を利用して、各タスクが独立した環境で実行され、悪意のあるコードがホストシステムに損害を与えるのを防ぎます。

🚀 クイックスタート

MCP Sandboxを使用するには、まず環境を構築する必要があります。以下の手順に従って操作してください。

📦 インストール

1. リポジトリのクローン

Gitコマンドを使用して、MCP Sandboxプロジェクトをローカルにクローンします。

git clone https://github.com/your-username/mcp-sandbox.git

2. 仮想環境の作成と依存関係の同期

プロジェクトディレクトリに移動した後、UVパッケージマネージャーをインストールし、依存関係を同期します。

uv create venv --name mcp-sandbox
cd venv && uv sync

3. サーバーの起動

MCP Sandboxサーバーを起動します。

uv run main:app

サーバーを起動した後、 http://localhost:8000/sse にアクセスすることで、MCP Sandboxツールを接続して使用できます。

✨ 主な機能

• Dockerによる隔離：各サンドボックス環境は独立したDockerコンテナで実行され、タスク間の相互影響を防ぎます。
• パッケージ管理：指定されたサンドボックス内で、numpyやpandasなどのサードパーティPythonパッケージのインストールをサポートします。
• ファイル生成とアクセス：生成されたすべてのファイル（画像、CSVなど）は、HTTPリンクを通じて直接アクセスでき、表示や埋め込みが容易です。

💻 使用例

基本的な使用法

1. サンドボックスの作成または選択

既存のサンドボックスを確認します。

mcp_sandbox list_sandboxes

利用可能なサンドボックスがない場合は、新しいサンドボックスを作成します。

mcp_sandbox create_sandbox

2. 必要なパッケージのインストール

指定されたサンドボックスに必要なパッケージをインストールします。

mcp_sandbox install_package --sandbox_id <your-sandbox-id> --package numpy

3. Pythonコードの実行

サンドボックス内でPythonコードを実行します。

mcp_sandbox execute_python_code --sandbox_id <your-sandbox-id> --code "import pandas as pd; print(pd.__version__)"

4. 結果とファイルの確認

実行後の出力、エラーメッセージ、および生成されたファイルのリンクが直接返され、さらなる処理や表示に便利です。

高度な使用法

以下は完全な使用例です。

import pandas as pd

# データを読み取り、CSVとして保存する
data = {'A': [1, 2, 3], 'B': [4, 5, 6]}
df = pd.DataFrame(data)
df.to_csv('output.csv', index=False)

# plt.savefig()を使用して画像を保存する
import matplotlib.pyplot as plt
plt.plot([1, 2, 3], [4, 5, 6])
plt.savefig('graph.png')

📚 ドキュメント

Claudeの設定例

{
  "mcpServers": {
    "mcpSandbox": {
      "command": "npx",
      "args": ["-y", "supergateway", "--sse",  "http://localhost:8000/sse"]
    }
  }
}

オンラインデモの設定例

{
  "mcpServers": {
    "mcpSandbox": {
      "command": "npx",
      "args": ["-y", "supergateway", "--sse",  "http://115.190.87.78/sse?api_key=<API_KEY>"]
    }
  }
}

⚠️ 重要提示

serverUrl パラメータは、ご自身の環境に合わせて調整してください。