Sandbox MCP

Installation

Download Binary

You can download and use the appropriate binary for your operating system and processor archetecture from the "Releases" page.

Install via Go

Prerequisites:

• Go 1.24 or higher

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

Get the path to the sandbox-mcp binary:

which sandbox-mcp

Build from Source

See Development section below.

Usage

Initilization

Before you use sandbox-mcp with LLMs, you need to initialize its configuration:

# Create the configuration directory and
# pull the default sandboxes from GitHub
sandbox-mcp --pull

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

With MCP Hosts/Clients

Add this to your claude_desktop_config.json for Claude Desktop or mcp.json for Cursor:

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

Available Sandboxes

shell

Run shell commands in a Linux environment with strict security and network constraints.

python

Run Python code with a set of pre-installed libraries.

network-tools

Use various network tools in an isolated Linux sandbox. The container has network access.

See jonlabelle/docker-network-tools for a list of available tools.

go

Run simple Go code in an isolated sandbox.

javascript

Run JavaScript code using Node.js.

Development

Fork and clone the repository:

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

Change into the directory:

cd sandbox-mcp

Install dependencies:

make deps

Build the project:

make build

Update your MCP servers configuration to point to the local build:

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

License

MIT License