Code Sandbox

by automata-labs-team

132 stars

682 downloads

Not rated

GitHub

About

Provides a sandboxed code execution environment for secure, multi-language code running with resource limits and network restrictions.

Details

Author: automata-labs-team
Repository: Automata-Labs-team/code-sandbox-mcp
GitHub stars: 132
Downloads: 682
License: MIT License
Categories: Developer Tools, Other, AI, Productivity, Design, Search, Automation, API, Project Management

- Flexible Container Management: Create and manage isolated Docker containers for code execution
- Custom Environment Support: Use any Docker image as your execution environment
- File Operations: Easy file and directory transfer between host and containers
- Command Execution: Run any shell commands within the containerized environment
- Real-time Logging: Stream container logs and command output in real-time
- Auto-Updates: Built-in update checking and automatic binary updates
- Multi-Platform: Supports Linux, macOS, and Windows

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Code Sandbox

Command (node, npx, python, etc.) /path/to/code-sandbox-mcp

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

{
    "mcpServers": {
        "code sandbox": {
            "env": {},
            "args": [],
            "command": "C:\\path\\to\\code-sandbox-mcp.exe"
        }
    }
}

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

{
    "mcpServers": {
        "code sandbox": {
            "env": {},
            "args": [],
            "command": "C:\\path\\to\\code-sandbox-mcp.exe"
        }
    }
}

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

{
    "mcpServers": {
        "code sandbox": {
            "env": {},
            "args": [],
            "command": "C:\\path\\to\\code-sandbox-mcp.exe"
        }
    }
}

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

{
    "mcpServers": {
        "code sandbox": {
            "env": {},
            "args": [],
            "command": "C:\\path\\to\\code-sandbox-mcp.exe"
        }
    }
}

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

{
    "mcpServers": {
        "code sandbox": {
            "env": {},
            "args": [],
            "command": "C:\\path\\to\\code-sandbox-mcp.exe"
        }
    }
}

JSON

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

From the repository

1. Download the latest release for your platform from the releases page
2. Place the binary in a directory in your PATH
3. Make it executable (Unix-like systems only):

   chmod +x code-sandbox-mcp

`sandbox_initialize`

Initialize a new compute environment for code execution. Creates a container based on the specified Docker image. Parameters: image (string, optional) - Docker image to use as the base environment (Default: 'python:3.12-slim-bookworm'). Returns: container_id that can be used with other tools to interact with this environment.

`copy_project`

Copy a directory to the sandboxed filesystem. Parameters: container_id (string, required) - ID of the container returned from the initialize call, local_src_dir (string, required) - Path to a directory in the local file system, dest_dir (string, optional) - Path to save the src directory in the sandbox environment.

`write_file`

Write a file to the sandboxed filesystem. Parameters: container_id (string, required) - ID of the container returned from the initialize call, file_name (string, required) - Name of the file to create, file_contents (string, required) - Contents to write to the file, dest_dir (string, optional) - Directory to create the file in (Default: ${WORKDIR}).

`sandbox_exec`

Execute commands in the sandboxed environment. Parameters: container_id (string, required) - ID of the container returned from the initialize call, commands (array, required) - List of command(s) to run in the sandboxed environment (Example: ["apt-get update", "pip install numpy", "python script.py"]).

`copy_file`

Copy a single file to the sandboxed filesystem. Parameters: container_id (string, required) - ID of the container returned from the initialize call, local_src_file (string, required) - Path to a file in the local file system, dest_path (string, optional) - Path to save the file in the sandbox environment.

`sandbox_stop`

Stop and remove a running container sandbox. Parameters: container_id (string, required) - ID of the container to stop and remove. Description: Gracefully stops the specified container with a 10-second timeout and removes it along with its volumes.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

{
    "env": [],
    "args": [],
    "command": "/path/to/code-sandbox-mcp"
}

Macos

{
    "env": [],
    "args": [],
    "command": "/path/to/code-sandbox-mcp"
}

Windows

{
    "env": [],
    "args": [],
    "command": "C:\\path\\to\\code-sandbox-mcp.exe"
}

Code Sandbox MCP 🐳

A secure sandbox environment for executing code within Docker containers. This MCP server provides AI applications with a safe and isolated environment for running code while maintaining security through containerization.

🌟 Features

🚀 Installation

Prerequisites

- Docker installed and running
- Install Docker for Linux
- Install Docker Desktop for macOS
- Install Docker Desktop for Windows

Quick Install

Linux, MacOS

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

Windows

```powershell

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

sandbox_initialize

copy_project

write_file

sandbox_exec

copy_file

sandbox_stop

Claude Desktop / Cursor

Linux

Macos

Windows

Code Sandbox MCP 🐳

🌟 Features

🚀 Installation

Prerequisites

Quick Install

Linux, MacOS

Windows

Install

More like this

Sequential Thinking

Sentry

Github

Filesystem

EverArt

Google Drive

`sandbox_initialize`

`copy_project`

`write_file`

`sandbox_exec`

`copy_file`

`sandbox_stop`