node-code-sandbox-mcp

🐢🚀 Node.js 沙盒 MCP 服务器

功能特性

• 启动和管理隔离的 Node.js 沙盒容器

• 在容器内执行任意 shell 命令

• 按需安装指定的 npm 依赖

• 运行 ES 模块的 JavaScript 代码片段并捕获标准输出

• 清理并销毁容器

• 分离模式（Detached Mode）：脚本执行后保持容器运行（例如用于长时间运行的服务器）

注意：容器运行时受到 CPU/内存限制的控制。

探索有趣的用例

⚠️ 前提条件

• node:lts-slim

• mcr.microsoft.com/playwright:v1.52.0-noble

• alfonsograziano/node-chartjs-canvas:latest

API

工具

run_js_ephemeral

• image（字符串，可选）：使用的 Docker 镜像（默认：node:lts-slim）。

• code（字符串，必填）：要执行的 JavaScript 源代码。

• dependencies（{ name, version } 数组，可选）：要安装的 npm 包及其版本（默认：[]）。

1. 创建一个全新的容器。

2. 写入 index.js 和一个最小的 package.json。

3. 安装指定的依赖。

4. 执行脚本。

5. 销毁（删除）容器。

6. 返回捕获的标准输出。

7. 如果你的代码在当前目录保存了任何文件，这些文件将自动返回。
• 图片（例如 PNG、JPEG）将作为 image 内容返回。
• 其他文件（例如 .txt、.json）将作为 resource 内容返回。
• 注意：文件保存功能目前仅在 run_js_ephemeral 工具中可用。

提示： 要获取文件，只需在脚本执行期间保存它们。

sandbox_initialize

• 输入：
• image（字符串，可选，默认：node:lts-slim）：沙盒使用的 Docker 镜像
• port（数字，可选）：如果设置，将此容器端口映射到主机

• 输出：容器 ID 字符串

sandbox_exec

• 输入：
• container_id（字符串）：来自 sandbox_initialize 的容器 ID
• commands（字符串数组）：要执行的 shell 命令数组

• 输出：每个命令的标准输出组合

run_js

• 输入：
• container_id（字符串）：来自 sandbox_initialize 的容器 ID
• code（字符串）：要运行的 JS 源代码（支持 ES 模块）
• dependencies（{ name, version } 数组，可选，默认：[]）：npm 包名称 → 语义化版本
• listenOnPort（数字，可选）：如果设置，保持进程运行并将此端口暴露给主机（分离模式）

• 行为：
1. 在容器内创建一个临时工作区
2. 写入 index.js 和一个最小的 package.json
3. 运行 npm install --omit=dev --ignore-scripts --no-audit --loglevel=error
4. 执行 node index.js 并捕获标准输出，或者如果设置了 listenOnPort，则在后台保持进程运行
5. 除非在分离模式下运行，否则清理工作区

• 输出：脚本的标准输出或后台执行通知

sandbox_stop

• 输入：
• container_id（字符串）：来自 sandbox_initialize 的容器 ID

• 输出：确认消息

使用建议

• 基于会话的工具（sandbox_initialize ➔ run_js ➔ sandbox_stop）适用于以下场景：
• 保持一个长期运行的沙盒容器开启。
• 在同一环境中运行多个命令或脚本。
• 逐步安装并复用依赖。

• 一次性执行（run_js_ephemeral）适用于以下场景：
• 快速实验或简单脚本。
• 不需要维护状态或缓存依赖的情况。
• 干净的原子化运行，无需手动清理。

• 分离模式适用于以下场景：
• 动态启动服务器或长时间运行的服务。
• 暴露并测试运行容器的端点。

与 Claude Desktop 结合使用

注意：确保你的工作目录指向构建的服务器，并且 Docker 已安装并运行。

Docker

与 VS Code 结合使用

构建

许可证