Sandbox MCP

🚀 砂箱 MCP 介紹

砂箱 MCP 是一款模型上下文協議（MCP）服務器，它允許大型語言模型（LLM，也就是 MCP 主機/客戶端）在 安全隔離的 Docker 容器中運行代碼。

雖然大型語言模型在代碼生成方面表現卓越，但大多數 無法執行它們所生成的代碼。這就導致你可能會直接在機器上運行未經測試的代碼，從而引發嚴重的意外後果。

而砂箱 MCP 賦予了大型語言模型安全測試代碼的能力，不僅能避免此類問題，還能幫助你 更快地生成更準確的代碼。它為大型語言模型提供了一個 易於使用的執行環境，任何人都可以通過簡單、AI 原生的 MCP 服務器在本地創建和配置。

• 本項目受 Codapi 啟發，部分砂箱與 Codapi 砂箱 相同。

🚀 快速開始

演示

此演示展示了砂箱 MCP 如何與 Claude Desktop 一起使用：

如果 GIF 不清晰，請嘗試觀看視頻 demo.mp4。

📦 安裝指南

下載二進制文件

您可以從 發佈頁面 下載適合您操作系統（例如 Darwin）和處理器架構（如 arm64）的二進制文件（例如：sandbox-mcp_Darwin_arm64.tar.gz）。

使用 Go 安裝

先決條件：

• Go 1.24 或更高版本

go install github.com/pottekkat/sandbox-mcp/cmd/sandbox-mcp@latest

獲取 sandbox-mcp 二進制文件的路徑：

which sandbox-mcp

從源代碼構建

請參見 開發部分。

💻 使用示例

初始化

在使用 sandbox-mcp 與 LLM 之前，需要初始化其配置：

# 創建配置目錄 $XDG_CONFIG_HOME/sandbox-mcp 並從 GitHub 拉取
# 默認砂箱
sandbox-mcp --pull

# 構建砂箱的 Docker 鏡像
sandbox-mcp --build

⚠️ 重要提示

請確保已安裝並運行 Docker。

與 MCP 主機/客戶端一起使用

將以下內容添加到您的 claude_desktop_config.json（適用於 Claude Desktop）或 mcp.json（適用於 Cursor IDE）中：

{
    "mcpServers": {
        "sandbox-mcp": {
            "command": "path/to/sandbox-mcp",
            "args": [
                "--stdio"
            ]
        }
    }
}

⚠️ 重要提示

請將 path/to/sandbox-mcp 替換為實際的 sandbox-mcp 二進制文件路徑。

📚 詳細文檔

可用砂箱

shell

在具有嚴格安全性和網絡限制的 Linux 環境中運行 shell 命令。

python

在一個預裝了特定庫的環境中運行 Python 代碼。

⚠️ 重要提示

您可以創建自己的砂箱以支持更多語言或工具，例如 Go、Java 或 SQL。

network_tools

在受限制的網絡環境中安全地執行網絡相關任務。

開發

# 叉取倉庫並切換到項目目錄
git clone https://github.com/pottekkat/sandbox-mcp.git && cd sandbox-mcp

# 安裝依賴項
npm install

# 構建 Docker 鏡像（位於 `docker/` 目錄中）
docker build -t sandbox-mcp .

# 運行測試
npm test

砂箱 MCP 為安全執行 LLM 生成的代碼提供了一個可靠的方法，對開發者和普通用戶都有一定的價值。