Playwright MCP Docker

提供Docker Compose环境来运行Playwright MCP服务器，方便与Cline或Cursor等客户端配合使用。

浏览器自动化开发者工具 #Docker环境 #MCP服务 #浏览器自动化

评分 : 2分

下载量 : 20

更新时间 : 2025-04-28

什么是Playwright MCP服务器?

Playwright MCP服务器是一个基于Docker的浏览器自动化服务，允许开发者通过简单的API调用控制浏览器行为。它特别适合需要浏览器自动化功能的开发场景，如网页测试、数据抓取等。

如何使用Playwright MCP服务器?

通过Docker Compose一键部署，支持两种运行模式(无界面/有界面)。配置完成后，可以通过SSE协议连接到客户端工具如VSCode/Cline。

适用场景

网页自动化测试、数据抓取、网页截图生成、前端开发调试等需要浏览器自动化的场景。

主要功能

Docker化部署提供开箱即用的Docker环境，无需复杂配置即可运行MCP服务器

双模式支持支持有界面和无界面两种运行模式，适应不同使用场景

SSE协议支持使用Server-Sent Events协议与客户端通信，实现实时交互

优势与局限性

优势

一键式部署，简化配置过程

跨平台支持，可在多种操作系统上运行

灵活的运行模式选择，适应不同需求

与主流开发工具(VSCode等)无缝集成

局限性

需要Docker环境支持

有界面模式在远程服务器上配置较复杂

对浏览器自动化新手学习曲线较陡

如何使用

环境准备

确保已安装Docker和Docker Compose

获取项目

克隆项目仓库到本地

配置环境

复制并编辑.env文件设置运行参数

启动服务

使用Docker Compose启动服务

客户端配置

在客户端工具中配置MCP服务器连接

使用案例

网页自动化测试使用MCP服务器运行端到端网页测试

数据抓取抓取动态加载的网页内容

常见问题

如何切换有界面/无界面模式?

服务启动后如何验证是否正常运行?

WSL环境下有界面模式不工作怎么办?

🚀 Playwright MCP Docker 环境

本项目提供了一个 Docker Compose 环境，用于运行 @playwright/mcp 服务器。借助该项目，你能够轻松完成 Playwright MCP 服务器的设置与管理，进而与 Cline 或 Cursor 等客户端协同使用。

🚀 快速开始

先决条件

Docker
Docker Compose

设置

克隆仓库

git clone <repository-url>
cd playwright-mcp-docker

创建 .env 文件 复制示例环境文件：
```
cp .env.sample .env
```
配置 .env 编辑 .env 文件，依据你的环境和偏好调整设置：
- MCP_HOST_PORT：主机机器上用于访问 MCP 服务器的端口（默认：8931）。
- HEADLESS：设置为 true 以无头模式运行（无浏览器 GUI），或 false 以有头模式运行（需要 GUI 设置）。默认为 true。
- (仅限有头模式) DISPLAY、WAYLAND_DISPLAY、XDG_RUNTIME_DIR：在 Linux 环境中用于 GUI 应用程序的环境变量（特别是 WSLg）。已提供默认值。
- (仅限有头模式) X11_HOST_PATH、WSLG_HOST_PATH：X11 和 WSLg 套接字/目录的主机路径。已提供默认值。若系统配置不同，请进行调整。对于 Windows Docker 访问 WSL 路径，使用 \\wsl.localhost\DistroName\... 格式（参见 .env.sample）。

运行服务器

构建并启动容器
```
docker-compose up --build -d
```
--build 标志仅在首次运行或 Dockerfile 更改时需要。-d 标志用于以分离模式运行容器（后台运行）。
配置 MCP 客户端（例如，VSCode/Cline）
- 添加或启用名为 playwright_sse 的 MCP 服务器（或任何你喜欢的名称）。
- 设置连接类型为 SSE。
- 设置 URL 为 http://localhost:<MCP_HOST_PORT>/sse（将 <MCP_HOST_PORT> 替换为 .env 文件中的值，例如 http://localhost:8931/sse）。
- 示例客户端配置（文件名取决于客户端）：
```
{
    "mcpServers": {
        "playwright_sse": { // 服务器名称任意
            "url": "http://localhost:8931/sse" // 匹配.env文件中的端口号
        }
    }
}
```

停止服务

docker-compose down

✨ 主要特性

提供 Docker Compose 环境，方便快捷地设置和管理 Playwright MCP 服务器。
支持无头和有头两种运行模式，可根据不同场景灵活切换。

📦 安装指南

按照上述“设置”和“运行服务器”的步骤操作，即可完成 Playwright MCP 服务器的安装与启动。

💻 使用示例

基础用法

# 克隆仓库
git clone <repository-url>
cd playwright-mcp-docker

# 创建.env文件
cp .env.sample .env

# 配置.env文件（可根据需求调整）

# 构建并启动容器
docker-compose up --build -d

# 配置MCP客户端（以示例JSON配置为例）
```json
{
    "mcpServers": {
        "playwright_sse": {
            "url": "http://localhost:8931/sse"
        }
    }
}