Bash-based sandbox for llms to play in.

Intended for your LLM harness to expose a run command that recieves bash instructions, then send the bash command into this container using docker exec or ssh.

Built-in mcp integration so your mcp connections also run separate from the harness

docker-compose.yml example

services:
  command_runner:
    build:
      context: ./sandbox
      dockerfile: Dockerfile
    container_name: command_runner
    hostname: command_runner
    volumes:
      - sandbox_home:/home/sandbox
      - ./sandbox/mcp-servers.json:/etc/mcp/mcp-servers.json:ro
    healthcheck:
      test: ["CMD", "echo", "ok"]
      interval: 10s
      timeout: 5s
      retries: 3

mcp-servers.json example

{
  "servers": [
    {
      "name": "example-server",
      "url": "http://mcp-server-host:3000/mcp",
      "headers": {
        "Authorization": "Bearer your_token_here"
      }
    }
  ]
}