Code Sandbox MCP

🚀 代碼沙箱 MCP 🐳

代碼沙箱 MCP 是一個基於 Docker 容器的安全隔離環境，專為 AI 應用程序中的代碼執行而設計。藉助容器化技術，該 MCP 服務器能提供安全且隔離的運行環境，有效保障代碼運行時的安全性。

🚀 快速開始

代碼沙箱 MCP 為 AI 應用程序提供了一個安全的代碼執行環境。通過容器化技術，它能確保代碼在獨立的環境中運行，避免對主機系統造成影響。以下是使用該工具的基本步驟：

1. 按照安裝指南完成安裝。
2. 根據配置指南進行相應配置。
3. 使用可用工具與代碼沙箱 MCP 進行交互。

✨ 主要特性

• 靈活的容器管理：可創建和管理隔離的 Docker 容器，用於代碼執行。
• 自定義環境支持：支持使用任何 Docker 鏡像作為運行環境。
• 文件操作：能輕鬆實現主機與容器之間的文件目錄傳輸。
• 命令執行：可在容器化環境中運行任意 shell 命令。
• 即時日誌：支持即時流式處理容器日誌和命令輸出。
• 自動更新：內置更新檢查和二進制文件自動更新功能。
• 多平臺支持：適用於 Linux、macOS 和 Windows 系統。

📦 安裝指南

先決條件

• 需安裝並運行 Docker：
  • 在 Linux 上安裝 Docker
  • 在 macOS 上安裝 Docker
  • 在 Windows 上安裝 Docker

快速安裝

在 Linux、macOS 或 Windows 上運行以下命令以下載並安裝代碼沙箱 MCP：

# 下載適用於 Linux/macOS 的二進制文件
wget https://github.com/Automata-Labs/code-sandbox-mcp/releases/download/v1.0.0/code-sandbox-mcp

# 或者下載適用於 Windows 的可執行文件
wget https://github.com/Automata-Labs/code-sandbox-mcp/releases/download/v1.0.0/code-sandbox-mcp.exe

# 為二進制文件設置可執行權限（僅限 Linux/macOS）
chmod +x code-sandbox-mcp

手動安裝

若需手動構建代碼沙箱 MCP，請參考 DEVELOPMENT.md。

🛠️ 可用工具

以下是可用於與代碼沙箱 MCP 交互的命令行工具：

• code-sandbox-mcp：主可執行文件，用於啟動和管理代碼沙箱服務。

工具參數

示例配置

{
    "containerImage": "docker.io/library/ubuntu:latest",
    "cpuQuota": 500,
    "memoryLimit": "1G"
}

🛡️ 安全特性

• 隔離執行環境：所有代碼均在獨立的 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 文件。