Code Sandbox

🚀 代碼沙盒MCP 🐳

一個基於Docker容器的安全沙盒環境，用於在AI應用程序中執行代碼。此MCP服務器藉助容器化技術，提供安全且隔離的環境，保障代碼運行時的安全性。

🚀 快速開始

代碼沙盒MCP是一個基於Docker容器的安全沙盒環境，可用於在AI應用程序中執行代碼。你可以按照以下步驟快速安裝和使用它。

✨ 主要特性

• 靈活的容器管理：創建和管理用於代碼執行的獨立Docker容器。
• 自定義環境支持：使用任何Docker鏡像作為執行環境。
• 文件操作：輕鬆實現主機與容器之間的文件和目錄傳輸。
• 命令執行：在容器化環境中運行任意shell命令。
• 即時日誌：即時流式處理容器日誌和命令輸出。
• 自動更新：內置更新檢查及二進制文件自動更新功能。
• 多平臺支持：適用於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

📚 詳細文檔

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即可。

🔧 技術細節

• 隔離執行環境：每個任務在獨立的Docker容器中運行，防止資源競爭和逃逸攻擊。
• 資源限制：設置CPU、內存使用上限，確保系統穩定性和性能。

🚀 開發指南

如需本地構建項目或參與開發，請參閱DEVELOPMENT.md。

📄 許可證

本項目採用MIT License協議。詳細信息請參考LICENSE文件。