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
- Docker instalado y en ejecución
Instalación rápida
Linux, MacOS
Ventanas
El instalador hará lo siguiente:
- Comprobar la instalación de Docker
- Descargue el binario apropiado para su sistema
- Crear los archivos de configuración necesarios
Instalación manual
- Descargue la última versión para su plataforma desde la página de lanzamientos
- Coloque el binario en un directorio en su PATH
- Hazlo ejecutable (sólo sistemas tipo Unix):Copy
🛠️ 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ónlocal_src_dir
(cadena, obligatoria): ruta a un directorio en el sistema de archivos localdest_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ónfile_name
(cadena, obligatoria): Nombre del archivo a crearfile_contents
(cadena, obligatorio): Contenido que se escribirá en el archivodest_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óncommands
(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ónlocal_src_file
(cadena, obligatoria): ruta a un archivo en el sistema de archivos localdest_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
macOS
Ventanas
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.
This server cannot be installed
Un servidor MCP para crear un entorno de espacio aislado de código seguro para ejecutar código dentro de contenedores Docker.