Playwright

You can run Playwright features as an MCP server so clients can control browser actions through a lightweight, server-sent events interface. This setup makes it easy to integrate Playwright capabilities into your MCP workflows across containers and host environments.

How to use

Connect to the server from any MCP client within the same network or from your host to run Playwright commands remotely. The server exposes an SSE endpoint that you can subscribe to for real-time browser automation actions.

How to install

Prerequisites: you must have Docker and docker-compose installed, and a Docker network named mcp-network created for inter-container communication.

Create the network if it does not exist:

docker network create mcp-network

Obtain the server files by cloning or downloading the project, then start the server in the project root:

docker compose up --build

When the server starts, you should see a confirmation line like: playwright-sse-mcp-server | Server is running on port 3002

If you want to use a different port, set the PORT environment variable before starting the server:

PORT=4000 docker compose up --build

The server will then log the custom port, for example: playwright-sse-mcp-server | Server is running on port 4000

Additional notes

The server communicates with MCP clients via SSE and runs Playwright in headless mode. It is designed to operate within a dedicated Docker network and supports both default and custom ports.

Available tools

start_server

Start the MCP server with default configuration and port 3002.

stop_server

Stop the MCP server process.

view_logs

Show real-time server logs to monitor activity and errors.