Playwright MCP Docker Environment

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

FAQ from Playwright MCP Docker Environment

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.