什麼是 Node.js 沙盒 MCP 服務器？

Node.js 沙盒 MCP 服務器是一個輕量級工具，允許您在一個受控環境中運行 JavaScript 代碼。它通過 Docker 容器提供隔離的運行時環境，支持動態安裝 npm 依賴並捕獲輸出結果。

如何使用 Node.js 沙盒 MCP 服務器？

您只需準備一個支持 Docker 的環境，然後按照指引啟動服務器並執行 JavaScript 腳本。您可以選擇一次性運行腳本或啟動持久化容器以測試長期運行的服務。

適用場景

適合需要快速驗證代碼、測試依賴或構建臨時開發環境的開發者。例如，運行實驗性代碼、生成圖表或測試第三方 API。

主要功能

動態安裝 npm 依賴根據需要自動安裝指定版本的 npm 包。

支持 ES 模塊可以運行基於 ES 模塊的 JavaScript 代碼。

持久化模式可以選擇讓容器保持運行狀態以支持長期任務。

多工具集成包括沙盒初始化、命令執行和腳本運行等功能。

優勢與侷限性

優勢

隔離性強，確保代碼運行安全。

支持動態依賴管理，減少手動配置。

靈活適配多種使用場景。

簡單易用，適合快速原型開發。

侷限性

需要本地安裝 Docker 環境。

長時間運行可能消耗較多系統資源。

對網絡環境有一定要求（如 Docker 圖像拉取）。

如何使用

安裝 Docker

確保您的計算機上已安裝 Docker 並正常運行。

啟動 MCP 服務器

通過 Docker 啟動 MCP 服務器。

執行代碼

使用 `run_js_ephemeral` 或 `sandbox_initialize` 等工具運行 JavaScript。

使用案例

快速運行腳本使用 `run_js_ephemeral` 快速運行一段 JavaScript。

持久化模式啟動容器並運行一個長期運行的 Node.js 服務。

常見問題

為什麼需要安裝 Docker？

如何清理不再使用的容器？

🚀 Node.js 砂箱 MCP 服務器

這是一個基於 Node.js 實現的 Model Context Protocol (MCP) 服務器，可在 ephemeral Docker 容器中運行任意 JavaScript 代碼，還支持依賴注入功能，為開發者提供了靈活且高效的代碼運行環境。

✨ 主要特性

MCP 兼容性：完全符合 Model Context Protocol 標準，能夠與 Claude 等 AI 工具實現無縫集成，方便開發者在不同的應用場景中使用。
Docker 集成：藉助 Docker 來運行和管理容器，有效確保了環境隔離和資源控制，讓代碼運行更加穩定和安全。
依賴注入：支持將宿主機的 Docker 套接字和其他卷掛載到容器中，使得執行復雜任務變得更加便捷，滿足多樣化的開發需求。
持久化輸出：可將容器內的輸出結果保存到宿主機指定目錄，方便用戶查看和管理運行結果。

📦 安裝指南

使用 Docker 運行

docker run --rm -it \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v "$HOME/Desktop/sandbox-output":"$HOME/Desktop/sandbox-output" \
  -e JS_SANDBOX_OUTPUT_DIR="$HOME/Desktop/sandbox-output" \
  alfonsograziano/node-code-sandbox-mcp stdio

手動構建

npm install
npm run build

💻 使用示例

與 VS Code 集成

在 settings.json 或 .vscode/mcp.json 中添加以下配置：

"mcp": {
    "servers": {
        "js-sandbox": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-v", "/var/run/docker.sock:/var/run/docker.sock",
                "-v", "$HOME/Desktop/sandbox-output:$HOME/Desktop/sandbox-output",
                "-e", "JS_SANDBOX_OUTPUT_DIR=$HOME/Desktop/sandbox-output",
                "alfonsograziano/node-code-sandbox-mcp"
              ]
        }
    }
}