Playwright MCP Docker Environment
2025.03.31
0
Shell浏览器自动化Web 应用开发浏览器自动化
Playwright MCP Docker Environment 是一个基于 Docker Compose 的环境，用于运行 `@playwright/mcp` 服务器。它允许用户轻松设置和管理 Playwright MCP 服务器，以便与 Cline 或 Cursor 等客户端一起使用。该项目的核心功能包括提供 Docker 化的 Playwright MCP 服务器环境，支持无头模式和有头模式，以及灵活的配置选项。适用场景包括浏览器自动化测试、Web 应用开发和调试等。
View on GitHub
Overview
基本能力
产品定位
Playwright MCP Docker Environment 是一个用于运行和管理 Playwright MCP 服务器的 Docker 化环境，主要用于浏览器自动化和 Web 应用开发。
核心功能
- 提供 Docker Compose 环境来运行
@playwright/mcp服务器 - 支持无头模式（Headless）和有头模式（Headed）
- 灵活的配置选项，包括端口设置、环境变量等
- 支持与客户端（如 Cline 或 Cursor）的集成
适用场景
- 浏览器自动化测试
- Web 应用开发和调试
- 需要与 Playwright MCP 服务器集成的开发环境
工具列表
- Docker
- Docker Compose
@playwright/mcp服务器
常见问题解答
- 如何切换无头模式和有头模式？
通过修改
.env文件中的HEADLESS变量为true或false，然后重启容器。 - 如何在 WSLg 上运行有头模式？
确保
.env文件中的路径设置正确，并匹配你的 WSL 发行版名称。
使用教程
使用依赖
- Docker
- Docker Compose
安装教程
- 克隆仓库：
bash git clone <repository-url> cd playwright-mcp-docker - 创建
.env文件：bash cp .env.sample .env - 配置
.env： 根据你的环境和偏好调整.env文件中的设置。
运行服务器
- 构建并启动容器：
bash docker-compose up --build -d - 配置 MCP 客户端：
添加或启用一个名为
playwright_sse的 MCP 服务器，设置连接类型为 SSE，URL 为http://localhost:<MCP_HOST_PORT>/sse。
调试方式
- 停止服务器：
bash docker-compose down - 切换模式：
修改
.env文件中的HEADLESS变量，然后重启容器。