Daytona Playwright MCP Server

An MCP (Model Context Protocol) server that lets you control a stealth patchright+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.

https://github.com/user-attachments/assets/23b13e1f-4ed3-4204-ad0d-b2fdb1f77d0d

Features

• Stealth Chrome: Real Chrome (not headless, via patchright's stealth patches) rendered into a virtual display

• Live VNC view: The signed preview URL returned by browser_start streams the sandbox desktop, so you can watch what Claude is doing

• 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

pipx install git+https://github.com/jamesmurdza/playwright-daytona-mcp-server.git

2. Get a Daytona API Key

1. Sign up at daytona.io

2. Go to your dashboard and generate an API key

3. Configure Claude Code / Claude Desktop

Add to your MCP settings:

{
  "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 and launch Chrome

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

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/jamesmurdza/playwright-daytona-mcp-server.git
cd playwright-daytona-mcp-server

# Install dependencies
uv sync

# Run the server
uv run daytona-playwright-mcp

Configure MCP for Development

When developing locally, use this MCP configuration:

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

Run Tests

uv run pytest

How It Works

1. When you call browser_start, the server:

   • Builds a minimal Daytona sandbox image declaratively (xfce + VNC stack for computer_use, plus patchright with the Chrome channel)

   • Starts computer_use so the sandbox desktop is streamed on port 6080 (the returned "Live view" URL)

   • Launches Chrome via patchright into DISPLAY=:0 with CDP bound on 0.0.0.0:9222 — no TCP proxy needed, since patchright's stealth patches are applied at launch time

   • Connects to Chrome over a signed CDP WebSocket through Daytona's secure preview URL

2. All browser commands are executed through the async 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

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