Code Sandbox

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

Dockerコンテナに基づく安全なサンドボックス環境で、AIアプリケーション内でコードを実行するために使用されます。このMCPサーバーは、コンテナ化技術を通じて安全で隔離された環境を提供し、コード実行時の安全性を確保します。

✨ 主な機能

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

📦 インストール

前提条件

• Dockerがインストールされ、実行中であること
  • LinuxでのDockerのインストール
  • macOSでのDocker Desktopのインストール
  • WindowsでのDocker Desktopのインストール

クイックインストール

Linux、macOS

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

Windows

iwr https://raw.githubusercontent.com/Automata-Labs/code-sandbox-mcp/main/install.ps1 -UseBasicParsing | invoke-Expression

手動インストール

code-sandbox-mcp実行可能ファイルを目的のディレクトリにダウンロードし、Unixシステムの場合は実行権限を付与します。

📚 ドキュメント

コマンド一覧

1. サンドボックス環境の初期化

code-sandbox-mcp initialize --config ./config.json

2. サンドボックスサービスの起動

code-sandbox-mcp start --bind 0.0.0.0:8080

3. サンドボックスサービスの停止

code-sandbox-mcp stop

4. コンテナの状態を確認

code-sandbox-mcp ps

🔧 技術詳細

セキュリティ機能

• 隔離された実行環境：各タスクは独立したDockerコンテナで実行され、リソース競合とエスケープ攻撃を防止します。
• リソース制限：CPUとメモリの使用上限を設定し、システムの安定性とパフォーマンスを確保します。

設定ガイド

Claude Desktopの設定

インストーラーは自動的に設定ファイルを作成します。手動で設定する場合は、以下の例を参考にしてください。

Linux

// ~/.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": {}
        }
    }
}

Windows

// %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でライセンスされています。詳細はLICENSEファイルを参照してください。