使用说明

项目简介

本项目旨在为 NixOS 用户提供最简便的方式来运行 Playwright MCP 服务器。它通过 Nix flake 打包了 Playwright 服务器和 Playwright MCP 服务器，解决了在 NixOS 上配置 Playwright 和 MCP 服务器时常见的环境依赖和版本不兼容问题。

主要功能点

简化 NixOS 部署: 一键部署 Playwright MCP 服务器及其依赖环境。
版本兼容: 同时打包 Playwright 和 MCP 服务器，确保版本兼容性，避免版本冲突错误。
集成 NixOS 包: 利用 NixOS 官方 Playwright 浏览器驱动包，保证稳定性和兼容性。
精简浏览器: 默认仅包含 Chromium 浏览器，减少下载体积。

安装步骤

确保你的 NixOS 系统已启用 Flakes 功能。

克隆本仓库（可选，'nix run' 命令无需克隆）：

git clone https://github.com/akirak/nix-playwright-mcp

服务器配置

以下 JSON 配置信息可用于 MCP 客户端连接本 MCP 服务器。

{
  "serverName": "NixPlaywrightMCP",
  "command": "nix",
  "args": [
    "run",
    "github:akirak/nix-playwright-mcp#mcp-server"
  ],
  "description": "在 NixOS 上运行由 nix-playwright-mcp 打包的 Playwright MCP 服务器。请确保 Playwright 服务器已运行，并根据需要正确设置 PLAYWRIGHT_WS_ENDPOINT 环境变量。",
  "notes": "如果 Playwright 服务器未运行在默认地址，你可能需要设置 PLAYWRIGHT_WS_ENDPOINT 环境变量来指定 Playwright 服务器的 WebSocket 端点。"
}

基本使用方法

启动 Playwright 服务器: 打开终端，运行命令：
```
nix run github:akirak/nix-playwright-mcp
```
记录终端输出的 WebSocket URL (例如：'ws://127.0.0.1:xxxxx/')。

启动 MCP 服务器: 打开另一个终端，运行命令：

nix run github:akirak/nix-playwright-mcp#mcp-server

如果 Playwright 服务器 WebSocket URL 不是默认地址，需要设置 'PLAYWRIGHT_WS_ENDPOINT' 环境变量。例如，如果 Playwright 服务器的 WebSocket URL 是 'ws://127.0.0.1:39127/'，则可以这样运行 MCP 服务器：

PLAYWRIGHT_WS_ENDPOINT=ws://127.0.0.1:39127/ nix run github:akirak/nix-playwright-mcp#mcp-server

配置 MCP 客户端: 在 MCP 客户端的服务器配置中，使用上面提供的 JSON 配置信息。

关键词