Playwright MCP Docker

剧作家MCP Docker环境

日语版在这里

该项目提供了一个Docker Compose环境来运行 @playwright/mcp 服务器。它允许您轻松设置和管理Playwright MCP服务器，以便与Cline或Cursor等客户端一起使用。

先决条件

• 码头工人
• Docker Compose

设置

1. 克隆存储库：

   git clone 
   cd playwright-mcp-docker

1. 创建 .env 文件：

复制示例环境文件：

   cp .env.sample .env

1. 配置 .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).

运行服务器

1. 构建并启动容器：

   docker-compose up --build -d

这 --build 仅在第一次或当 Dockerfile 变化。这 -d flag以分离模式（在后台）运行容器。

1. 配置MCP客户端（例如，VSCode/Cline）：

- 添加或启用名为的MCP服务器 playwright_sse （或任何你喜欢的名字）。 - 将连接类型设置为 SSE. - 将URL设置为 http://localhost:/sse （替换 ` 与您的价值 .env 文件。， http://localhost:8931/sse`). - 客户端配置示例（文件名取决于客户端）：

   {
     "mcpServers": {
       "playwright_sse": { // Server name is arbitrary
         "url": "http://localhost:8931/sse" // Match the port number in .env
       }
     }
   }

配置详情

• .env 文件： 管理特定于环境的设置，如端口、无头模式和头模式的路径。
• docker-compose.yml: 定义Docker服务，从中读取变量 .env，设置端口映射和卷。
• Dockerfile: 定义Docker镜像，安装 @playwright/mcp 以及它的依赖项（包括Chrome）。
• entrypoint.sh: 容器启动时运行的脚本，传递正确的参数(--headless 或 --port)到 npx @playwright/mcp 命令基于 HEADLESS 环境变量。

切换模式

• 无头模式： 集 HEADLESS=true 在……里面 .env.重新启动容器： docker-compose up -d.
• 头部模式： 集 HEADLESS=false 在……里面 .env。确保您的主机环境（例如WSLg或X Server）设置正确。重新启动容器： docker-compose up -d.

标题模式注释（WSLg）

• 如果您在Windows上使用WSLg docker-compose.yml 以及WSL2特定路径 .env.sample 通常应该有效。确保你的路径 .env 如果不是，请匹配您的WSL分发名称 Ubuntu.
• 如果您没有使用WSLg（例如，标准Linux桌面或带有单独X服务器的macOS/Windows），则需要调整 DISPLAY 可变和潜在的卷装载量(X11_HOST_PATH)在你的 .env 根据您的X Server设置创建文件。

停止服务器

docker-compose down