Metadata-Version: 2.4
Name: iflow-mcp_boxlite-ai-boxlite-mcp
Version: 0.2.5
Summary: MCP server providing computer use capabilities through an isolated sandbox environment
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: automation,computer-use,isolation,mcp,sandbox
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Requires-Dist: anyio>=4.0.0
Requires-Dist: boxlite>=0.5.10
Requires-Dist: httpx<1.0,>=0.27.0
Requires-Dist: mcp>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# 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](https://boxlite-labs.github.io/website/) 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://youtu.be/JjwLg6ww234)

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

```bash
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):

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

### Manual Installation

```bash
pip install boxlite-mcp
```

## Development

```bash
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

```bash
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):

```json
{
  "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
