MCP コードサンドボックスサーバー

隔離されたサンドボックス環境で安全なコード実行機能を提供する、拡張可能なメッセージ通信プロトコル（MCP）サーバーです。このサーバーはMCP標準に準拠しており、Claude for Desktopやその他のMCPクライアントと互換性があります。

特徴

• コード実行用の隔離されたサンドボックス環境を作成する

• Pythonコードを安全に実行する

• ファイル操作（リスト、読み取り、書き込み）を実行する

• サンドボックスにPythonパッケージをインストールする

• 抽象化されたコードインタープリタインターフェースを備えた拡張可能なアーキテクチャ

• 明確な関心の分離を備えたモジュール設計

Related MCP server: Discord MCP Server

建築

サーバーはモジュール式の拡張可能なアーキテクチャで構築されています。

コアコンポーネント

• 抽象インタープリタインターフェース: 異なるコード実行バックエンドを統合できる

• サンドボックス管理: サンドボックス環境を作成および管理するためのツール

• コード実行: コードを実行し、パッケージをインストールするためのツール

• ファイル操作: サンドボックス内のファイルを管理するためのツール

プロジェクト構造

前提条件

• Python 3.10以上

• E2B API キー（デフォルトの E2B インタープリタ用）

インストール

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

   git clone https://github.com/yourusername/mcp-code-sandbox.git cd mcp-code-sandbox

2. 仮想環境をセットアップします。

   # Using venv python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate # Or using uv (recommended) uv init uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate

3. 必要なパッケージをインストールします。

   # Using pip pip install fastmcp python-dotenv e2b-code-interpreter # Or using uv uv add fastmcp python-dotenv e2b-code-interpreter

4. 環境変数を設定します。

   # Create a .env file with the following variables E2B_API_KEY=your_e2b_api_key_here INTERPRETER_TYPE=e2b # Default, can be changed to other implemented interpreters

使用法

サーバーをスタンドアロンで実行する

コマンドラインから直接サーバーを実行できます。

これにより、stdio トランスポートを使用してサーバーが起動され、Claude for Desktop との互換性が確保されます。

Claude for Desktop と併用

1. Claude for Desktopの最新バージョンがインストールされていることを確認してください

2. Claude for Desktop の構成ファイルを開きます。

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. コード サンドボックス サーバーの構成を追加します。

   { "mcpServers": { "code-sandbox": { "command": "python", "args": [ "/ABSOLUTE/PATH/TO/main.py" ] } } }

   またはuvを使用している場合:

   { "mcpServers": { "code-sandbox": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/PROJECT_DIRECTORY", "run", "main.py" ] } } }

4. ファイルを保存し、Claude for Desktopを再起動します。

利用可能なツール

サーバーは次のツールを提供します。

サンドボックス管理

• create_sandbox : 新しいサンドボックス環境を作成する

• close_sandbox : サンドボックスを閉じてクリーンアップする

• get_sandbox_status : サンドボックスのステータスを確認する

コード実行

• execute_code : サンドボックスでPythonコードを実行する

• install_package : Python パッケージをインストールする

• create_run_close : サンドボックスを作成し、コードを実行し、クリーンアップするオールインワンツール

ファイル操作

• list_files : サンドボックス内のファイルを一覧表示する

• read_file : ファイルの内容を読み取る

• write_file : ファイルにコンテンツを書き込む

• upload_file : サンドボックスにファイルをアップロードする

新しいインタープリタによる拡張

システムは拡張性を考慮して設計されています。新しいコードインタープリターを追加するには、以下の手順に従ってください。

1. インタープリタ実装用にsrc/sandbox/の下に新しいディレクトリを作成します。

2. src/sandbox/code_interpreter.pyとsrc/sandbox/file_interface.pyで定義されたインターフェースを実装します。

3. 新しいインタープリタタイプをsrc/sandbox/interpreter_factory.pyに追加します。

4. 環境変数INTERPRETER_TYPEを新しいインタープリターに設定します

新しいインタープリターの実装例:

モジュールの説明

サンドボックスコア ( src/sandbox/ )

• code_interpreter.py : コードインタープリタの抽象基本クラス

• file_interface.py : ファイル操作のための抽象インターフェース

• interpreter_factory.py : コードインタープリタインスタンスを作成するためのファクトリー

E2B実装 ( src/sandbox/e2b/ )

• e2b_interpreter.py : コードインタープリタのE2B実装

• e2b_file_interface.py : ファイル操作の E2B 実装

ツール ( tools/ )

• sandbox_tools.py : サンドボックス管理用のツール

• code_execution_tools.py : コード実行用のツール

• file_tools.py : ファイル操作用のツール

主な用途

• main.py : メインアプリケーションのエントリポイント

トラブルシューティング

問題が発生した場合:

• 選択したインタープリターの正しいAPIキーがあることを確認してください

• 詳細なエラーメッセージについてはログを確認してください

• 必要なパッケージがすべてインストールされていることを確認する

• Claude for Desktop がスクリプトへの正しいパスで設定されていることを確認します

セキュリティに関する考慮事項

• コード実行は安全のためサンドボックス環境で行われる

• このサーバーを本番環境で信頼できないコードを実行するために使用しないでください

• サーバーは現在認証を実装していません。信頼できる環境でのみ使用してください。

ライセンス

MITライセンス