Sandbox MCP Server

🚀 砂箱 MCP 服務器

砂箱 MCP 服務器提供了一個隔離的 Docker 環境，用於代碼執行。它允許用戶使用任何 Docker 鏡像創建容器，在多種編程語言中編寫和執行代碼，安裝包並設置開發環境，還能在隔離的容器中運行命令。

🚀 快速開始

✨ 主要特性

• 支持使用任何 Docker 鏡像創建容器。
• 可在多種編程語言中編寫和執行代碼。
• 能夠安裝包並設置開發環境。
• 可在隔離的容器中運行命令。

📦 安裝指南

先決條件

• Python 3.9 或更高版本
• 已安裝並正在運行的 Docker
• uv 包管理器（推薦）
• Docker MCP 服務器（推薦）

安裝步驟

1. 克隆此倉庫：

git clone <your-repo-url>
cd sandbox_server

2. 創建並激活帶有 uv 的虛擬環境：

uv venv
source .venv/bin/activate  # 在 Unix/MacOS 上
# 或在 Windows 上：
# .venv\Scripts\activate

3. 安裝依賴項：

uv pip install .

與 Claude Desktop 的集成

1. 打開 Claude Desktop 的配置文件：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json%

2. 添加沙盒服務器的配置：

{
    "mcpServers": {
        "sandbox": {
            "command": "uv",
            "args": [
                "--directory",
                "/absolute/path/to/sandbox_server",
                "run",
                "sandbox_server.py"
            ],
            "env": {
                "PYTHONPATH": "/absolute/path/to/sandbox_server"
            }
        }
    }
}

請將 /absolute/path/to/sandbox_server 替換為實際項目目錄的路徑。

3. 重啟 Claude Desktop

💻 使用示例

基礎用法

一旦連接到 Claude Desktop，您可以：

1. 創建一個 Python 容器：

你能創建一個 Python 容器並編寫一個簡單的“你好，世界”程序嗎？

2. 在不同語言中運行代碼：

你能創建一個計算斐波那契數列的 C 程序並運行它嗎？

3. 安裝包並使用它們：

你能創建一個使用 numpy 生成和繪製一些隨機數據的 Python 腳本嗎？

高級用法

保存和重現實驗環境

該服務器提供了多種方法來保存和重現您的開發環境：

創建持久化容器

在創建容器時，您可以將其設置為持久化：

你能創建一個帶有 numpy 和 pandas 安裝的持久化 Python 容器嗎？

這將創建一個容器，該容器：

• 在 Claude Desktop 關閉後仍然運行
• 可以直接通過 Docker 訪問
• 保留所有已安裝的包和文件

服務器會提供以下指示：

• 直接使用 docker exec 訪問容器
• 容器的停止和啟動
• 不再需要時刪除它

保存容器狀態

你能保存容器的狀態到一個持久化容器中嗎？

導出 Dockerfile

你能導出一個 docker 文件以創建持久化環境嗎？

退出容器

你能關閉容器以便清理環境嗎？

⚠️ 重要提示

• 確保在運行外部命令時使用受信任的來源。
• 避免在不受信任的環境中執行用戶提供的代碼。