Skip to main content

MCP server providing computer use capabilities through an isolated sandbox environment

Project description

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

License

Apache-2.0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

boxlite_mcp-0.2.0.tar.gz (14.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

boxlite_mcp-0.2.0-py3-none-any.whl (13.1 kB view details)

Uploaded Python 3

File details

Details for the file boxlite_mcp-0.2.0.tar.gz.

File metadata

  • Download URL: boxlite_mcp-0.2.0.tar.gz
  • Upload date:
  • Size: 14.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for boxlite_mcp-0.2.0.tar.gz
Algorithm Hash digest
SHA256 54666fab00e26cf7cbc72e0dbd0260bbb3bb9a123c4b07bb6d851a39b8984c43
MD5 4bac58928d1d3749b0686ee560ad18b8
BLAKE2b-256 fbf0c57eebc57edb3bcd45e153ac9bc44e9fbbd14f6cf7102d3b9a7a203a8d7d

See more details on using hashes here.

File details

Details for the file boxlite_mcp-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: boxlite_mcp-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 13.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for boxlite_mcp-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 398d37f65a9937fbe2b4aaca30b71d22b6832d30e36867a587b8d2f939a4b166
MD5 a112e8595753499acff5bfbf0b13f03c
BLAKE2b-256 6fdfcfd7dc190f1f497a9dfc225ed8e4b8c192c67505f2c849b5808ca02509ac

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page