Sandbox MCP

Sandbox MCP es un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los LLM (hosts/clientes MCP) ejecutar código en contenedores Docker seguros y aislados .

Si bien los LLM son muy buenos generando código, la mayoría no puede ejecutarlo . Al final, este código no probado se ejecuta directamente en el equipo, lo que podría tener consecuencias drásticas.

Proporcionar a los LLM las herramientas para probar el código de forma segura previene dichos problemas y ayuda a generar un código más preciso en menos iteraciones .

Sandbox MCP ofrece a los LLM un entorno de ejecución fácil de usar que cualquiera puede crear y configurar a través de un servidor MCP simple y nativo de IA que se ejecuta localmente.

Inspirado en Codapi . Algunos entornos de pruebas son iguales a los de Codapi .

Casos de uso

Sandbox MCP se puede utilizar para muchas tareas diferentes, incluidas, entre otras:

• Ejecución segura de código : ejecute cualquier código generado por un LLM en un entorno seguro y aislado, protegiendo su sistema de código no confiable o potencialmente dañino.

• Pruebas de código : pruebe y valide automáticamente el código en varios lenguajes y/o configuraciones en varios entornos antes de integrarlo en proyectos más grandes o sistemas de producción.

• Validación de código de usuario : ejecute y verifique de forma segura el código o los scripts enviados por el usuario, garantizando que se comporten como se espera y no realicen acciones maliciosas.

• Solución de problemas de red : diagnostique problemas de conectividad, pruebe puntos finales y analice el rendimiento de la red utilizando herramientas de red aisladas, todo sin exponer su sistema.

• Codificación educativa y de entrevistas : compile y ejecute instantáneamente fragmentos de código para entrevistas de aprendizaje, enseñanza o técnicas, brindando retroalimentación inmediata en un entorno temporal y seguro.

• Revisión y retroalimentación de código automatizadas : permite que los LLM ejecuten, prueben y revisen el código automáticamente, ofreciendo sugerencias o comentarios prácticos antes de fusionar o implementar el código.

Related MCP server: Code Sandbox MCP Server

Manifestación

Esta demostración muestra cómo funciona Sandbox MCP con Claude Desktop.

Prueba el video si el GIF no es claro.

Instalación

Descargar binario

Puede descargar el binario apropiado para su sistema operativo (por ejemplo, Darwin ) y arquitectura de procesador ( arm64 ) desde la página de versiones ( sandbox-mcp_Darwin_arm64.tar.gz ).

Instalar mediante Go

Prerrequisitos:

• Vaya a 1.24 o superior

go install github.com/pottekkat/sandbox-mcp/cmd/sandbox-mcp@latest

Obtenga la ruta al binario sandbox-mcp :

which sandbox-mcp

Construir desde la fuente

Vea la sección Desarrollo .

Uso

Inicialización

Antes de usar sandbox-mcp con LLM, debe inicializar su configuración:

# Create the configuration directory in
# $XDG_CONFIG_HOME/sandbox-mcp and pull
# the default sandboxes from GitHub
sandbox-mcp --pull

# Build the Docker images for the sandboxes
sandbox-mcp --build

[!NOTA] Asegúrese de tener Docker instalado y en ejecución.

Con hosts/clientes de MCP

Agregue esto a su claude_desktop_config.json para Claude Desktop o mcp.json para Cursor IDE:

{
    "mcpServers": {
        "sandbox-mcp": {
            "command": "path/to/sandbox-mcp",
            "args": [
                "--stdio"
            ]
        }
    }
}

[!NOTA] Asegúrese de reemplazar path/to/sandbox-mcp con la ruta real al binario sandbox-mcp .

Sandboxes disponibles

[!IMPORTANTE]

Tu propia caja de arena

Puedes crear y añadir tus propios entornos de pruebas en $XDG_CONFIG_HOME/sandbox-mcp/sandboxes . Un entorno de pruebas es básicamente un Dockerfile y una configuración JSON. Consulta los ejemplos y la guía para obtener más información.

Desarrollo

Bifurcar y clonar el repositorio:

git clone https://github.com/username/sandbox-mcp.git

Cambiar al directorio:

cd sandbox-mcp

Instalar dependencias:

make deps

Construir el proyecto:

make build

Actualice la configuración de sus servidores MCP para que apunten a la compilación local:

{
    "mcpServers": {
        "sandbox-mcp": {
            "command": "/path/to/sandbox-mcp/dist/sandbox-mcp",
            "args": [
                "--stdio"
            ]
        }
    }
}

Licencia

Licencia MIT