Name: Playwright MCP Docker环境
Author: d1gl3

使用说明

剧作家MCP Docker环境

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

克隆存储库：

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 flag以分离模式（在后台）运行容器。
配置MCP客户端（例如，VSCode/Cline）：
- 添加或启用名为的MCP服务器 playwright_sse （或任何你喜欢的名字）。
- 将连接类型设置为 上海证券交易所.
- 将URL设置为 http://localhost:<MCP_HOST_PORT>/sse （替换 <MCP_HOST_PORT> 与您的价值 .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.

如果您在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