概览
What is playwright-sse-mcp-server?
playwright-sse-mcp-server provides Playwright as an MCP (Model Context Protocol) server, enabling MCP clients to use Playwright’s browser automation features. It runs inside a Docker container and is intended for developers who need browser control from MCP-compatible tools.
How to use playwright-sse-mcp-server?
Clone the repository and run docker compose up --build in the project root. The server starts on port 3002 by default; set the PORT environment variable for a custom port. Connect from other containers on the same Docker network via playwright-sse-mcp-server:<PORT>/sse, or from the host via localhost:<PORT>/sse. For Roo Code, configure the MCP settings with the SSE URL. Helper shell scripts (playwright-mcp-start, playwright-mcp-stop, playwright-mcp-logs) are provided for convenient control.
Key features of playwright-sse-mcp-server
- Playwright browser automation exposed via MCP SSE transport
- Docker‑based deployment with configurable port (default 3002)
- Connects from same Docker network, host, or development containers
- Shell scripts for start/stop/logs with persistent mode and restart policies
- Requires a pre‑existing Docker network named
mcp-network
Use cases of playwright-sse-mcp-server
- Use an MCP client like Roo Code to automate browser tasks
- Run headless Playwright inside a container for testing or scraping
- Integrate browser automation into MCP‑based workflows
FAQ from playwright-sse-mcp-server
What are the prerequisites for running the server?
Docker and docker‑compose must be installed. A Docker network named mcp-network must exist; if not, create it with docker network create mcp-network.
How do I connect from a development container not on mcp-network?
Use the host IP or special DNS name. On Docker Desktop (Mac/Windows) use host.docker.internal:<PORT>/sse. On Linux, use the host’s IP or the Docker bridge gateway (e.g., 172.17.0.1). The port must match the one published in compose.yml.
Does Cline support this server?
As of 2025/03/27, Cline does not support SSE, so it cannot be used with this server.
Can I change the default port?
Yes, set the environment variable PORT before starting the server. For example: PORT=4000 docker compose up --build.
What mode does Playwright run in?
The server runs Playwright in headless mode.
