Playwright MCP Docker Environment

@iuill

Repository

Basic information

About Playwright MCP Docker Environment

This project provides a Docker Compose environment to run the '@playwright/mcp' server.

#playwright #docker #automation

Playwright MCP Docker Environment config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "playwright_sse": {
      "type": "http",
      "url": "http://localhost:8931/sse"
    }
  }
}

Playwright MCP Docker Environment tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list directly from this server's endpoint using the button above.

Overview

What is Playwright MCP Docker Environment?

It is a Docker Compose environment that runs the @playwright/mcp server, enabling easy setup and management of the Playwright MCP server for use with clients like Cline or Cursor.

How to use Playwright MCP Docker Environment?

Clone the repository, copy .env.sample to .env, configure settings (port, headless mode, etc.), then build and start the container with docker-compose up --build -d. Configure your MCP client to use SSE with the URL http://localhost:<MCP_HOST_PORT>/sse. Stop the server with docker-compose down.

Key features of Playwright MCP Docker Environment

Docker Compose based setup with minimal dependencies
Supports headless and headed browser modes
Configurable host port via MCP_HOST_PORT environment variable
Built-in Chrome installation for Playwright
Compatible with WSLg for headed mode on Windows

Use cases of Playwright MCP Docker Environment

Running Playwright MCP server in a containerized environment
Automating browser tasks via MCP clients (e.g., Cline, Cursor)
Testing web applications in a reproducible Docker setup
Using headed mode for visual debugging on Linux with X11/WSLg

Frequently asked questions

What are the prerequisites?

Docker and Docker Compose must be installed on the host system.

How do I switch between headless and headed mode?

Set `HEADLESS=true` or `HEADLESS=false` in the `.env` file and restart the container with `docker-compose up -d`.

Does this work on Windows with WSLg?

Yes, default settings in `.env.sample` and `docker-compose.yml` are configured for WSLg. Adjust the WSL distribution name in paths if it is not `Ubuntu`.

What transport protocol does the MCP server use?

The MCP server uses SSE (Server-Sent Events) on the configured host port.

How do I stop the server?

Run `docker-compose down` from the project directory.

Comments

More Browser Automation MCP servers

QuantumProxies — Residential, Mobile & Datacenter Proxy MCP Server

quantumproxies

Give your AI agent its own proxies. QuantumProxies exposes residential, mobile, datacenter, ISP and IPv6 endpoints as MCP tools: list your plans, generate ready-to-use proxy strings with credentials, target by country, s