MCP.so
Sign In

🐢🚀 Node.js Sandbox MCP Server

@alfonsograziano

Repository

About 🐢🚀 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#javascript#typescript#docker

Basic information

Category

Reasoning

Runtime

node

Transports

stdio

Publisher

alfonsograziano

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "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"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

FAQ from 🐢🚀 Node.js Sandbox MCP Server

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.

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.

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.

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.

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).

Comments

More Reasoning MCP servers

MCP Advanced Reasoning Server for Cursor AI

AzDeltaQQ

This is a very basic implementation of an Mcp-Reasoning-Server for Cursor AI .

13

Agentic Tools MCP Server

Pimzino

A comprehensive Model Context Protocol (MCP) server providing AI assistants with powerful task management and agent memories capabilities with project-specific storage.

87

Agenticstore — The Open Source Standard For Local Mcp Tooling

agenticstore

AgenticStore: The secure toolkit for AI agents. Instantly equip Claude Desktop, Cursor, and Windsurf with 27+ MCP tools, persistent memory, and SearXNG search, all protected by a built-in PII prompt firewall to protect your data from being exposed to AI agents.

4

Agentic Radar

splx-ai

A security scanner for your LLM agentic workflows

993

Sandbox Mcp

pottekkat

A Model Context Protocol (MCP) server that enables LLMs to run ANY code safely in isolated Docker containers.

118