Code Sandbox MCP

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Executes code within isolated Docker containers for secure sandboxed environments, with support for Python, Go, and Node.js code execution and dependency management.

  • Supports running Node.js code and projects with automatic dependency detection via require/import statements and package.json, including built-in TypeScript support.

  • Allows execution of Python code snippets and projects with automatic dependency detection and installation via pip, requirements.txt, pyproject.toml, or setup.py.

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

Dockerコンテナ内でコードを実行するための安全なサンドボックス環境。このMCPサーバーは、コンテナ化によってセキュリティを維持しながら、AIアプリケーションに安全で隔離されたコード実行環境を提供します。

🌟 特徴

  • 柔軟なコンテナ管理: コード実行用の分離された Docker コンテナを作成および管理します。
  • カスタム環境のサポート: 任意の Docker イメージを実行環境として使用できます
  • ファイル操作: ホストとコンテナ間のファイルとディレクトリの簡単な転送
  • コマンド実行: コンテナ化された環境内で任意のシェルコマンドを実行します。
  • リアルタイムログ:コンテナのログとコマンド出力をリアルタイムでストリーミング
  • 自動更新: 組み込みの更新チェックと自動バイナリ更新
  • マルチプラットフォーム: Linux、macOS、Windowsをサポート

🚀 インストール

前提条件

クイックインストール

Linux、MacOS

curl -fsSL https://raw.githubusercontent.com/Automata-Labs-team/code-sandbox-mcp/main/install.sh | bash

ウィンドウズ

# Run in PowerShell irm https://raw.githubusercontent.com/Automata-Labs-team/code-sandbox-mcp/main/install.ps1 | iex

インストーラーは次のことを実行します。

  1. Dockerのインストールを確認する
  2. システムに適したバイナリをダウンロードしてください
  3. 必要な設定ファイルを作成する

手動インストール

  1. リリースページから、お使いのプラットフォームの最新リリースをダウンロードしてください。
  2. バイナリをPATH内のディレクトリに配置する
  3. 実行可能にする (Unix 系システムのみ):
    chmod +x code-sandbox-mcp

🛠️ 利用可能なツール

sandbox_initialize

コード実行用の新しいコンピューティング環境を初期化します。指定された Docker イメージに基づいてコンテナを作成します。

パラメータ:

  • image (文字列、オプション): ベース環境として使用する Docker イメージ
    • デフォルト: 'python:3.12-slim-bookworm'

戻り値:

  • この環境と対話するために他のツールで使用できるcontainer_id

copy_project

ディレクトリをサンドボックス化されたファイルシステムにコピーします。

パラメータ:

  • container_id (文字列、必須): 初期化呼び出しから返されたコンテナのID
  • local_src_dir (文字列、必須): ローカルファイルシステム内のディレクトリへのパス
  • dest_dir (文字列、オプション): サンドボックス環境の src ディレクトリを保存するパス

write_file

サンドボックス化されたファイルシステムにファイルを書き込みます。

パラメータ:

  • container_id (文字列、必須): 初期化呼び出しから返されたコンテナのID
  • file_name (文字列、必須): 作成するファイルの名前
  • file_contents (文字列、必須): ファイルに書き込む内容
  • dest_dir (文字列、オプション): ファイルを作成するディレクトリ (デフォルト: ${WORKDIR})

sandbox_exec

サンドボックス環境でコマンドを実行します。

パラメータ:

  • container_id (文字列、必須): 初期化呼び出しから返されたコンテナのID
  • commands (配列、必須): サンドボックス環境で実行するコマンドのリスト
    • 例: ["apt-get update", "pip install numpy", "python script.py"]

copy_file

サンドボックス化されたファイルシステムに単一のファイルをコピーします。

パラメータ:

  • container_id (文字列、必須): 初期化呼び出しから返されたコンテナのID
  • local_src_file (文字列、必須): ローカルファイルシステム内のファイルへのパス
  • dest_path (文字列、オプション): サンドボックス環境でファイルを保存するパス

sandbox_stop

実行中のコンテナ サンドボックスを停止して削除します。

パラメータ:

  • container_id (文字列、必須): 停止して削除するコンテナのID

**説明:**指定されたコンテナを 10 秒のタイムアウトで正常に停止し、ボリュームとともに削除します。

コンテナログリソース

コンテナ ログへのアクセスを提供する動的リソース。

リソースパス: containers://{id}/logs
MIMEタイプ: text/plain
**説明:**指定されたコンテナからのすべてのコンテナ ログを単一のテキスト リソースとして返します。

🔐 セキュリティ機能

  • Dockerコンテナを使用した分離された実行環境
  • Dockerコンテナの制約によるリソース制限
  • stdout と stderr ストリームを分離する

🔧 構成

クロードデスクトップ

インストーラーは自動的に設定ファイルを作成します。手動で設定する必要がある場合は、以下の手順に従ってください。

リナックス

// ~/.config/Claude/claude_desktop_config.json { "mcpServers": { "code-sandbox-mcp": { "command": "/path/to/code-sandbox-mcp", "args": [], "env": {} } } }

macOS

// ~/Library/Application Support/Claude/claude_desktop_config.json { "mcpServers": { "code-sandbox-mcp": { "command": "/path/to/code-sandbox-mcp", "args": [], "env": {} } } }

ウィンドウズ

// %APPDATA%\Claude\claude_desktop_config.json { "mcpServers": { "code-sandbox-mcp": { "command": "C:\\path\\to\\code-sandbox-mcp.exe", "args": [], "env": {} } } }

その他のAIアプリケーション

MCP サーバーをサポートするその他の AI アプリケーションの場合は、コード実行バックエンドとしてcode-sandbox-mcpバイナリを使用するように構成します。

🛠️ 開発

プロジェクトをローカルでビルドしたり、開発に貢献したりしたい場合は、 DEVELOPMENT.md を参照してください。

📝 ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

-
security - not tested
A
license - permissive license
-
quality - not tested

Docker コンテナ内でコードを実行するための安全なコード サンドボックス環境を作成する MCP サーバー。

  1. 🌟 Features
    1. 🚀 Installation
      1. Prerequisites
      2. Quick Install
      3. Manual Installation
    2. 🛠️ Available Tools
      1. sandbox_initialize
      2. copy_project
      3. write_file
      4. sandbox_exec
      5. copy_file
      6. sandbox_stop
      7. Container Logs Resource
    3. 🔐 Security Features
      1. 🔧 Configuration
        1. Claude Desktop
        2. Other AI Applications
      2. 🛠️ Development
        1. 📝 License
          ID: v1l1r5f6ek