Каталог MCP
alfonsograziano/node-code-sandbox-mcp

alfonsograziano/node-code-sandbox-mcp

Node.js Sandbox MCP сервер для запуска JavaScript в изолированных Docker-контейнерах с динамической установкой npm-пакетов. Возвращает stdout и сохранённые файлы. Полезен для ИИ-агентов и тестирования скриптов без риска.

README

7 инструментов

Версии

Установить сервер

🐢🚀 Node.js Sandbox MCP Server

Node.js server implementing the Model Context Protocol (MCP) for running arbitrary JavaScript in ephemeral Docker containers with on‑the‑fly npm dependency installation.

Website Preview

👉 Look at the official website

📦 Available on Docker Hub

Features

Start and manage isolated Node.js sandbox containers
Execute arbitrary shell commands inside containers
Install specified npm dependencies per job
Run ES module JavaScript snippets and capture stdout
Tear down containers cleanly
Detached Mode: Keep the container alive after script execution (e.g. for long-running servers)

Note: Containers run with controlled CPU/memory limits.

Explore Cool Use Cases

If you want ideas for cool and powerful ways to use this library, check out the use cases section on the website It contains a curated list of prompts, examples, and creative experiments you can try with the Node.js Sandbox MCP Server.

⚠️ Prerequisites

To use this MCP server, Docker must be installed and running on your machine.

Tip: Pre-pull any Docker images you'll need to avoid delays during first execution.

Инструменты были проиндексированы: 11.09.2026

get_dependency_types

Принимает массив названий npm-пакетов (и опционально версии), получает, поставляет ли каждый пакет собственные определения TypeScript или имеет соответствующий пакет @types/…, и возвращает сырой текст .d.ts. Полезно, когда вы собираетесь запустить скрипт Node.js с незнакомой зависимостью и хотите изучить, какие API и типы она предоставляет.

Параметры

dependenciesobject[]обязательный

run_js

Устанавливает npm-зависимости и выполняет JavaScript-код внутри запущенного контейнера-песочницы. После выполнения необходимо вручную остановить песочницу, чтобы освободить ресурсы. Код должен быть написан в формате ESModules (синтаксис import/export). Подходит для сложных рабочих процессов, где требуется повторно использовать окружение при нескольких запусках. При чтении из процессов Node.js и записи в них всегда читайте и записывайте данные в каталог "./files", чтобы обеспечить сохранность данных на подключенном томе.

Параметры

codestringобязательный
JavaScript code to run inside the container.
container_idstringобязательный
Docker container identifier
dependenciesobject[]
A list of npm dependencies to install before running the code. Each item must have a name (package) and version (range). If none, returns an empty array.
listenOnPortnumber
If set, leaves the process running and exposes this port to the host.

run_js_ephemeral

Запускает JavaScript-фрагмент во временном одноразовом контейнере с опциональными npm-зависимостями, затем автоматически выполняет очистку. Код должен быть валидным ESModules (синтаксис import/export). Подходит для однократных простых выполнений без поддержания песочницы или ручного управления очисткой. При чтении и записи из процессов Node.js всегда нужно читать и записывать в каталог "./files", чтобы обеспечить сохранность на смонтированном томе. Это включает изображения (например, PNG, JPEG) и другие файлы (например, текст, JSON, бинарники).

Параметры

codestringобязательный
JavaScript code to run inside the ephemeral container.
dependenciesobject[]
A list of npm dependencies to install before running the code. Each item must have a name (package) and version (range). If none, returns an empty array.
imagestring
Docker image to use for ephemeral execution. e.g. - node:lts-slim: Node.js LTS version, slim variant. (Lightweight and fast for JavaScript execution tasks.) - mcr.microsoft.com/playwright:v1.53.2-noble: Playwright image for browser automation. (Preconfigured for running Playwright scripts.) - alfonsograziano/node-chartjs-canvas:latest: Chart.js image for chart generation and mermaid charts generation. ('Preconfigured for generating charts with chartjs-node-canvas and Mermaid. Minimal Mermaid example: import fs from "fs"; import { run } from "@mermaid-js/mermaid-cli"; fs.writeFileSync("./files/diagram.mmd", "graph LR; A-->B;", "utf8"); await run("./files/diagram.mmd", "./files/diagram.svg");)

sandbox_exec

Выполняет одну или несколько команд оболочки внутри запущенного sandbox-контейнера. Требует предварительно инициализированного sandbox.

Параметры

commandsstring[]обязательный
container_idstringобязательный

sandbox_initialize

Запускает новый изолированный Docker-контейнер с Node.js. Используется для настройки изолированной сессии для нескольких команд и скриптов.

Параметры

imagestring
portnumber
If set, maps this container port to the host

sandbox_stop

Завершает и удаляет запущенный контейнер sandbox. Следует вызывать после завершения работы в sandbox, инициализированном с помощью sandbox_initialize.

Параметры

container_idstringобязательный

search_npm_packages

Ищет npm-пакеты по поисковому запросу и возвращает их название, описание и фрагмент README.

Параметры

qualifiersobject
Optional qualifiers to filter the search results. For example, { not: "insecure" } will exclude insecure packages, { author: "sindresorhus" } will only show packages by that author, { scope: "@vue" } will only show Vue.js scoped packages.
searchTermstringобязательный
The term to search for in npm packages. Should contain all relevant context. Should ideally be text that might appear in the package name, description, or keywords. Use plus signs (+) to combine related terms (e.g., "react+components" for React component libraries). For filtering by author, maintainer, or scope, use the qualifiers field instead of including them in the search term. Examples: "express" for Express.js, "ui+components" for UI component packages, "testing+jest" for Jest testing utilities.

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "node-code-sandbox-mcp"
  ],
  "env": {
    "FILES_DIR": "/Users/alfonsograziano/Desktop/node-sandbox",
    "SANDBOX_MEMORY_LIMIT": "512m",
    "SANDBOX_CPU_LIMIT": "0.75"
  },
  "type": "stdio"
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

FAQ

Для чего этот сервер?

Этот сервер запускает JavaScript-код в изолированных Docker-контейнерах с автоматической установкой npm-зависимостей. Он нужен, чтобы безопасно исполнять непроверенные скрипты, генерировать файлы вроде изображений и тестировать код без риска для主机ной системы. Разработчики используют его как изолированную песочницу для экспериментов, быстрых прототипов и длительных процессов, например веб-серверов, без загрязнения окружения.

Что он умеет?

Сервер запускает JavaScript-код в изолированных Docker-контейнерах. Он создаёт песочницу, выполняет внутри неё shell-команды, устанавливает npm-зависимости и останавливает контейнер по завершении. Есть разовый запуск скрипта в одноразовом контейнере с автоочисткой. Сервер ищет npm-пакеты по названию, показывает описание и фрагмент README. Он проверяет, поставляют ли пакеты собственные TypeScript-определения. Вывод скриптов возвращается в виде stdout, а сохранённые файлы отдаются как ресурсы или изображения.

Информация о сервере

Номер в рейтинге: #174
Звезд на Github: 157
Форков на Github: 33
Загрузок: 1 662
Язык реализации: TypeScript
Лицензия: неизвестно
Официальный сервер: Нет
Дата обновления данных: 10.09 в 23:17
Идентификатор: L62kAopS66fZhIu8
Категории: Автоматизация ОС, Виртуализация, Выполнение кода, Доступ к командной строке, Инструменты для разработчиков