Playwright MCP Docker Environment

@iuill

About Playwright MCP Docker Environment

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

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.

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.

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

Basic information

More Browser Automation MCP servers

Puppeteer

modelcontextprotocol

Model Context Protocol Servers

88.1K

Scrapling Fetch MCP

cyberchitta

Helps AI assistants access text content from bot-protected websites. MCP server that fetches HTML/markdown from sites with anti-automation measures using Scrapling.

101