mcp server

boxlite-mcp

Powered by BoxLite - embeddable sandbox with hardware-level isolation and no daemon. The SQLite of sandbox, coming soon as open source.

boxlite-ai/boxlite-mcpcommunitylistedunreviewed

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

uv (`curl -LsSf https://astral.sh/uv/install.sh | sh`)

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "boxlite-mcp": {
      "command": "uvx",
      "args": [
        "boxlite-mcp"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 17, 2026

boxlite-mcp

MCP server providing isolated sandbox environments for AI agents.

The Problem

Today's AI apps don't just generate text – they write and run code, call tools, read your files, and hit the network. Running all of this directly on your machine creates real risks:

Security - Malicious or buggy code can damage your system
Privacy - Sensitive files and credentials are exposed
Reliability - Runaway processes can consume resources or crash your machine

BoxLite solves this by giving AI agents their own isolated VM – full freedom inside, complete safety outside.

Powered by BoxLite

BoxLite is an embeddable virtual machine runtime that follows the SQLite philosophy - simple, lightweight, and zero-configuration.

Why BoxLite?

Hardware-level isolation - True VM security, not just containers. Your AI agent runs in a completely isolated environment.
No daemon required - Unlike Docker, BoxLite doesn't need a background service. Just import and use.
Embeddable - Designed to be embedded directly into your applications, like SQLite for compute.
Fast startup - VMs boot in seconds, not minutes.
Cross-platform - Works on macOS and Linux.

Use Cases

AI Agent Sandboxing - Let AI agents execute code, browse the web, and use applications safely
Secure Code Execution - Run untrusted code without risk to your host system
Browser Automation - Headless browser with CDP for web scraping and testing
Development Environments - Disposable, reproducible dev environments

Demo

▶️ Watch the demo on YouTube

https://github.com/user-attachments/assets/0685d428-64e4-4a68-adfe-c24dc0dc5ae8

Available Tools

Tool	Description
`computer`	Full Ubuntu desktop with XFCE. Anthropic computer use API compatible.
`browser`	Chromium browser with CDP endpoint for Puppeteer/Playwright/Selenium
`code_interpreter`	Python code execution sandbox
`sandbox`	Generic container for running shell commands

Quick Start

Claude Code

claude mcp add boxlite -- uvx boxlite-mcp

Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "boxlite": {
      "command": "uvx",
      "args": ["boxlite-mcp"]
    }
  }
}

Manual Installation

pip install boxlite-mcp

Development

git clone https://github.com/boxlite-labs/boxlite-mcp.git
cd boxlite-mcp
uv sync --extra dev
uv run pytest

Connect Local Server to Claude Code

claude mcp add boxlite -s local \
  -e BOXLITE_HOME=$HOME/.boxlite-mcp \
  -- uv run --directory /path/to/boxlite-mcp python -m server

Note: Environment variables must be passed via -e, not inline in the args. MCP stdio servers bypass the shell, so VAR=value command syntax won't work.

Connect Local Server to Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "boxlite": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/boxlite-mcp", "python", "-m", "server"],
      "env": {
        "BOXLITE_HOME": "/path/to/.boxlite-mcp"
      }
    }
  }
}

License

Apache-2.0