Code Sandbox MCP

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Executes code within isolated Docker containers for secure sandboxed environments, with support for Python, Go, and Node.js code execution and dependency management.

  • Supports running Node.js code and projects with automatic dependency detection via require/import statements and package.json, including built-in TypeScript support.

  • Allows execution of Python code snippets and projects with automatic dependency detection and installation via pip, requirements.txt, pyproject.toml, or setup.py.

Código Sandbox MCP 🐳

Un entorno sandbox seguro para ejecutar código dentro de contenedores Docker. Este servidor MCP proporciona a las aplicaciones de IA un entorno seguro y aislado para ejecutar código, manteniendo la seguridad mediante la contenedorización.

🌟 Características

  • Gestión flexible de contenedores : cree y administre contenedores Docker aislados para la ejecución de código
  • Compatibilidad con entornos personalizados : utilice cualquier imagen de Docker como entorno de ejecución
  • Operaciones de archivos : transferencia sencilla de archivos y directorios entre el host y los contenedores
  • Ejecución de comandos : ejecute cualquier comando de shell dentro del entorno contenedorizado
  • Registro en tiempo real : transmita registros de contenedores y salida de comandos en tiempo real
  • Actualizaciones automáticas : comprobación de actualizaciones integrada y actualizaciones binarias automáticas
  • Multiplataforma : compatible con Linux, macOS y Windows

🚀 Instalación

Prerrequisitos

Instalación rápida

Linux, MacOS

curl -fsSL https://raw.githubusercontent.com/Automata-Labs-team/code-sandbox-mcp/main/install.sh | bash

Ventanas

# Run in PowerShell irm https://raw.githubusercontent.com/Automata-Labs-team/code-sandbox-mcp/main/install.ps1 | iex

El instalador hará lo siguiente:

  1. Comprobar la instalación de Docker
  2. Descargue el binario apropiado para su sistema
  3. Crear los archivos de configuración necesarios

Instalación manual

  1. Descargue la última versión para su plataforma desde la página de lanzamientos
  2. Coloque el binario en un directorio en su PATH
  3. Hazlo ejecutable (sólo sistemas tipo Unix):
    chmod +x code-sandbox-mcp

🛠️ Herramientas disponibles

sandbox_initialize

Inicializa un nuevo entorno de cómputo para la ejecución de código. Crea un contenedor basado en la imagen de Docker especificada.

Parámetros:

  • image (cadena, opcional): imagen de Docker que se utilizará como entorno base
    • Predeterminado: 'python:3.12-slim-bookworm'

Devoluciones:

  • container_id que se puede utilizar con otras herramientas para interactuar con este entorno

copy_project

Copiar un directorio al sistema de archivos aislado.

Parámetros:

  • container_id (cadena, obligatoria): ID del contenedor devuelto de la llamada de inicialización
  • local_src_dir (cadena, obligatoria): ruta a un directorio en el sistema de archivos local
  • dest_dir (cadena, opcional): ruta para guardar el directorio src en el entorno sandbox

write_file

Escribe un archivo en el sistema de archivos aislado.

Parámetros:

  • container_id (cadena, obligatoria): ID del contenedor devuelto de la llamada de inicialización
  • file_name (cadena, obligatoria): Nombre del archivo a crear
  • file_contents (cadena, obligatorio): Contenido que se escribirá en el archivo
  • dest_dir (cadena, opcional): Directorio donde crear el archivo (predeterminado: ${WORKDIR})

sandbox_exec

Ejecutar comandos en el entorno aislado.

Parámetros:

  • container_id (cadena, obligatoria): ID del contenedor devuelto de la llamada de inicialización
  • commands (matriz, obligatorio): lista de comandos para ejecutar en el entorno aislado
    • Ejemplo: ["apt-get update", "pip install numpy", "python script.py"]

copy_file

Copiar un solo archivo al sistema de archivos aislado.

Parámetros:

  • container_id (cadena, obligatoria): ID del contenedor devuelto de la llamada de inicialización
  • local_src_file (cadena, obligatoria): ruta a un archivo en el sistema de archivos local
  • dest_path (cadena, opcional): ruta para guardar el archivo en el entorno sandbox

sandbox_stop

Detener y eliminar un contenedor sandbox en ejecución.

Parámetros:

  • container_id (cadena, obligatoria): ID del contenedor que se va a detener y eliminar

Descripción: Detiene elegantemente el contenedor especificado con un tiempo de espera de 10 segundos y lo elimina junto con sus volúmenes.

Recurso de registros de contenedores

Un recurso dinámico que proporciona acceso a los registros de contenedores.

Ruta del recurso: containers://{id}/logs
Tipo MIME: text/plain
Descripción: Devuelve todos los registros del contenedor especificado como un único recurso de texto.

🔐 Funciones de seguridad

  • Entorno de ejecución aislado mediante contenedores Docker
  • Limitaciones de recursos a través de las restricciones del contenedor Docker
  • Separar flujos stdout y stderr

🔧 Configuración

Escritorio de Claude

El instalador crea automáticamente el archivo de configuración. Si necesita configurarlo manualmente:

Linux

// ~/.config/Claude/claude_desktop_config.json { "mcpServers": { "code-sandbox-mcp": { "command": "/path/to/code-sandbox-mcp", "args": [], "env": {} } } }

macOS

// ~/Library/Application Support/Claude/claude_desktop_config.json { "mcpServers": { "code-sandbox-mcp": { "command": "/path/to/code-sandbox-mcp", "args": [], "env": {} } } }

Ventanas

// %APPDATA%\Claude\claude_desktop_config.json { "mcpServers": { "code-sandbox-mcp": { "command": "C:\\path\\to\\code-sandbox-mcp.exe", "args": [], "env": {} } } }

Otras aplicaciones de IA

Para otras aplicaciones de IA que admiten servidores MCP, configúrelas para utilizar el binario code-sandbox-mcp como su backend de ejecución de código.

🛠️ Desarrollo

Si desea construir el proyecto localmente o contribuir a su desarrollo, consulte DEVELOPMENT.md .

📝 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

-
security - not tested
A
license - permissive license
-
quality - not tested

Un servidor MCP para crear un entorno de espacio aislado de código seguro para ejecutar código dentro de contenedores Docker.

  1. 🌟 Features
    1. 🚀 Installation
      1. Prerequisites
      2. Quick Install
      3. Manual Installation
    2. 🛠️ Available Tools
      1. sandbox_initialize
      2. copy_project
      3. write_file
      4. sandbox_exec
      5. copy_file
      6. sandbox_stop
      7. Container Logs Resource
    3. 🔐 Security Features
      1. 🔧 Configuration
        1. Claude Desktop
        2. Other AI Applications
      2. 🛠️ Development
        1. 📝 License
          ID: v1l1r5f6ek