Playwright MCP Docker Environment

Name: Playwright MCP Docker Environment
Author: iuill

@iuill

Repository

About Playwright MCP Docker Environment

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

#playwright #docker #automation

Basic information

Config

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

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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

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.