Daytona Playwright MCP Server

An MCP (Model Context Protocol) server that lets you control a full Chrome browser running inside a Daytona cloud sandbox. Use it with Claude Code, Claude Desktop, or any MCP-compatible client to browse the web, take screenshots, fill forms, and more.

Features

• Full Chromium Browser: Runs a real Chromium instance (not headless) in a virtual display

• Cloud Sandbox: Browser runs securely in a Daytona sandbox, isolated from your local machine

• Rich Tool Set: Navigate, click, type, scroll, take screenshots, extract content, manage tabs

• Screenshot Support: Returns screenshots as images that Claude can see and analyze

• Multiple Transports: Works with stdio (default), SSE, or HTTP

Quick Start

1. Install the Package

# Using uv (recommended)
uv pip install git+https://github.com/YOUR_USERNAME/daytona-playwright-mcp.git

# Or with pip
pip install git+https://github.com/YOUR_USERNAME/daytona-playwright-mcp.git

# Or install from source
git clone https://github.com/YOUR_USERNAME/daytona-playwright-mcp.git
cd daytona-playwright-mcp
uv pip install -e .

2. Get a Daytona API Key

1. Sign up at daytona.io

2. Go to your dashboard and generate an API key

3. Set it as an environment variable:

export DAYTONA_API_KEY="your-api-key-here"

3. Configure Claude Code

Add to your Claude Code MCP settings (~/.claude/claude_desktop_config.json or via Claude Code settings):

{
  "mcpServers": {
    "daytona-playwright": {
      "command": "daytona-playwright-mcp",
      "env": {
        "DAYTONA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Or if running from source with uv:

{
  "mcpServers": {
    "daytona-playwright": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/daytona-playwright-mcp", "daytona-playwright-mcp"],
      "env": {
        "DAYTONA_API_KEY": "your-api-key-here"
      }
    }
  }
}

4. Configure Claude Desktop

For Claude Desktop, add to your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "daytona-playwright": {
      "command": "daytona-playwright-mcp",
      "env": {
        "DAYTONA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Usage

Once configured, you can ask Claude to browse the web:

"Start a browser and go to https://news.ycombinator.com"

"Take a screenshot of the page"

"Click on the first article link"

"Search for 'AI news' on Google and show me the results"

"Fill out the contact form on example.com with test data"

Workflow

1. Start the browser: Claude will call browser_start to create a Daytona sandbox with Chromium

2. Navigate and interact: Use navigation, clicking, typing, and other tools

3. Take screenshots: See what's on the page with browser_screenshot

4. Clean up: Call browser_stop when done to delete the sandbox

Available Tools

Browser Lifecycle

Navigation

Interaction

Content Extraction

Waiting

Tab Management

File Operations

Running with Different Transports

Stdio (Default - for Claude Code/Desktop)

daytona-playwright-mcp
# or
uv run daytona-playwright-mcp

HTTP Transport (for remote connections)

daytona-playwright-mcp --transport http --host 0.0.0.0 --port 8765

Then connect via: http://localhost:8765/mcp

SSE Transport (legacy)

daytona-playwright-mcp --transport sse --host 0.0.0.0 --port 8765

Environment Variables

Development

Run from Source

# Clone the repository
git clone https://github.com/YOUR_USERNAME/daytona-playwright-mcp.git
cd daytona-playwright-mcp

# Install dependencies
uv sync

# Run the server
uv run daytona-playwright-mcp

Run Tests

uv run pytest

How It Works

1. When you call browser_start, the server:

   • Creates a Daytona sandbox (default Python sandbox has Chromium + Xvfb pre-installed)

   • Launches Chromium with remote debugging enabled

   • Starts a TCP proxy to expose the CDP port externally

   • Connects to Chromium via CDP (Chrome DevTools Protocol) through Daytona's secure signed URLs

2. All browser commands are executed through the Playwright API connected to the remote browser

3. Screenshots are captured as PNG images and returned via MCP's image content type

4. When you call browser_stop, the sandbox is deleted and all resources are freed

Troubleshooting

"DAYTONA_API_KEY environment variable is not set"

Make sure your API key is configured in the MCP server settings, not just in your shell.

Browser fails to start

• Check that your Daytona API key is valid

• The browser image may take 1-2 minutes to provision on first use

• Increase the timeout parameter if needed

Screenshots not appearing

• Make sure you're using a recent version of Claude Code/Desktop that supports MCP images

• The browser_screenshot tool returns an Image type that should render automatically

Connection timeouts

The default timeout is 60 seconds. For slower connections or first-time image builds, increase it:

"Start a browser with a 120 second timeout"

License

MIT

Credits

• Based on the Daytona browser-in-sandbox pattern by synacktraa

• Uses Patchright for Playwright CDP connectivity

• Built with FastMCP for the MCP server

• Powered by Daytona cloud sandboxes