MCP.so
登录

Node.js Sandbox MCP Server

@alfonsograziano

基本信息

分类

推理

传输方式

stdio

作者

alfonsograziano

关于 Node.js Sandbox MCP Server

A Node.js–based Model Context Protocol server that spins up disposable Docker containers to execute arbitrary JavaScript.

Node.js Sandbox MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

Node.js Sandbox MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表,不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is 🐢🚀 Node.js Sandbox MCP Server?

It is a Node.js server implementing the Model Context Protocol (MCP) for running arbitrary JavaScript in ephemeral Docker containers with on‑the‑fly npm dependency installation. It is for developers and AI agents who need an isolated, sandboxed JavaScript execution environment.

How to use 🐢🚀 Node.js Sandbox MCP Server?

Install and run via Docker or npx, then configure your MCP client (e.g., Claude Desktop, VS Code) with the provided JSON config. Pass environment variables like FILES_DIR, SANDBOX_MEMORY_LIMIT, and SANDBOX_CPU_LIMIT. Use tools such as run_js_ephemeral for one‑off scripts or sandbox_initialize → run_js → sandbox_stop for session‑based workflows.

Key features of 🐢🚀 Node.js Sandbox MCP Server

  • Isolated Docker containers for each sandbox.
  • Execute shell commands inside running containers.
  • Install specified npm packages per job.
  • Run ES module JavaScript snippets and capture stdout.
  • Clean teardown of containers after use.
  • Detached mode for long‑running servers (background processes).

Use cases of 🐢🚀 Node.js Sandbox MCP Server

  • Quick one‑off JavaScript experiments with automatic cleanup.
  • Run multi‑step scripts in a persistent sandbox environment.
  • Spin up temporary servers with exposed ports for testing.
  • Search npm packages and test them in isolation.
  • Generate files (e.g., QR codes, images) and retrieve them automatically.

常见问题

1

What are the prerequisites?

Docker must be installed and running on your machine. Pre‑pulling images like `node:lts-slim` is recommended to avoid delays.

2

How do I get files back from a script?

Save files during script execution in the container’s working directory. Images (PNG, JPEG) are returned as image content; other files (e.g., .txt, .json) are returned as resource content. This feature is available only in the `run_js_ephemeral` tool.

3

What is detached mode?

Detached mode keeps the container alive after script execution, allowing long‑running services (e.g., servers) to stay active in the background. Use `run_js` with the `listenOnPort` parameter.

4

How can I limit container resources?

Set environment variables `SANDBOX_MEMORY_LIMIT` (e.g., `512m`) and `SANDBOX_CPU_LIMIT` (e.g., `0.5`) when launching the server.

5

Can I use custom Docker images?

Yes. The `image` parameter in tools like `run_js_ephemeral` and `sandbox_initialize` accepts any Docker image (default is `node:lts-slim`).

评论

推理 分类下的更多 MCP 服务器