Nix Playwright MCP

剧作家MCP服务器-NixOS Flake

Playwright MCP（模型上下文协议）服务器的全面NixOS Flake开发环境，支持Chrome和Firefox，包括持久浏览器配置文件。

特性

• ✅ 完成剧作家MCP服务器设置：基于微软的官方实施
• ✅ 多浏览器支持：包括Chrome/Chromium和Firefox浏览器
• ✅ 配置文件持久性：在会话之间维护浏览器配置文件
• ✅ 桌面配置文件集成：可以从桌面导入现有的Chrome/Firefox配置文件
• ✅ NixOS集成：为NixOS正确配置所有依赖项
• ✅ 开发环境：具备所有工具的即用型开发shell
• ✅ AI代理兼容：可以作为URL添加到AI代理的开发环境中

快速开始

与direnv一起使用（推荐）

1. 克隆此存储库或复制 flake.nix 到你的项目
2. 启用direnv： direnv allow
3. 当您进入目录时，环境将自动激活

手动激活

# Enter the development shell
nix develop

# Or run the MCP server directly
nix run

用法

运行MCP服务器

# Basic usage (headed mode, persistent profiles)
playwright-mcp-wrapped

# Headless mode
playwright-mcp-wrapped --headless

# Specify browser
playwright-mcp-wrapped --browser firefox

# With custom configuration
playwright-mcp-wrapped --config /path/to/config.json

# Server mode (for remote connections)
playwright-mcp-wrapped --port 8931

设置浏览器配置文件

要使用现有的桌面浏览器配置文件，请执行以下操作：

# Run the profile setup script
nix run .#setup-profiles

这将把您现有的Chrome/Chromium和Firefox配置文件复制到Playwright MCP目录：

• 铬： ~/.local/share/playwright-mcp/chrome-profile
• 火狐浏览器： ~/.local/share/playwright-mcp/firefox-profile

配置

该薄片包含一个可以自定义的默认配置文件。主要特点：

• 浏览器支持：Chromium和Firefox
• 配置文件持久性：配置文件在会话之间保存
• 头部模式：默认情况下，浏览器窗口可见
• 全功能：启用了所有MCP功能（选项卡、PDF、历史记录、等待、文件、安装、测试）

在AI开发环境中使用

将此flake添加为开发环境URL：

{
  "devEnvironments": {
    "playwright-mcp": {
      "url": "github:benjaminkitt/playwright-mcp-nix"
    }
  }
}

或者对于Claude Desktop MCP配置：

{
  "mcpServers": {
    "playwright": {
      "command": "nix",
      "args": ["run", "github:benjaminkitt/playwright-mcp-nix"]
    }
  }
}

建筑

这种薄片提供：

1. 定制剧作家MCP包：用NixOS特定配置包裹微软的Playwright MCP服务器
2. 浏览器集成：正确配置Chromium和Firefox，支持Playwright
3. 配置文件管理：处理浏览器配置文件持久性和桌面集成的脚本
4. 开发环境：完整的shell，包含所有依赖项和有用的环境变量

浏览器配置文件位置

默认位置

• 铬/铬型材: ~/.local/share/playwright-mcp/chrome-profile
• Firefox配置文件: ~/.local/share/playwright-mcp/firefox-profile

桌面配置文件源

安装脚本将在以下位置查找现有配置文件：

• 铬: ~/.config/google-chrome
• 铬: ~/.config/chromium
• 火狐: ~/.mozilla/firefox （默认配置文件）

配置选项

MCP服务器支持通过命令行参数进行广泛配置：

--allowed-origins      # Semicolon-separated allowed origins
--blocked-origins      # Semicolon-separated blocked origins
--browser             # Browser to use: chrome, firefox, webkit, msedge
--headless            # Run in headless mode
--user-data-dir       # Custom profile directory
--viewport-size       # Browser viewport size (e.g., "1920,1080")
--device              # Device to emulate (e.g., "iPhone 15")
--proxy-server        # Proxy server configuration
--storage-state       # Path to storage state file
--isolated            # Use isolated (non-persistent) profiles
--vision              # Use screenshot mode instead of accessibility snapshots
--config              # Path to JSON configuration file

故障排除

未找到浏览器

如果您收到浏览器未找到错误：

nix run .#playwright-mcp -- --browser chromium
# or
export PLAYWRIGHT_BROWSERS_PATH=$(nix-build '' -A playwright-driver.browsers --no-out-link)

配置文件问题

如果浏览器配置文件不起作用：

# Reset profiles
rm -rf ~/.local/share/playwright-mcp/
nix run .#setup-profiles

权限问题

确保配置文件目录可写：

chmod -R u+w ~/.local/share/playwright-mcp/

贡献

这种薄片设计得易于扩展。主要贡献领域：

1. 浏览器支持：其他浏览器配置
2. 配置文件管理：增强的配置文件导入/导出功能
3. 配置：更复杂的配置管理
4. 整合：更好地与各种AI开发环境集成

许可证

此项目遵循与底层Playwright MCP服务器（Apache 2.0）相同的许可证。

相关项目

• 微软剧作家MCP -上游MCP服务器
• natsukium/mcp服务器nix -MCP服务器的Nix框架
• akirak/nix剧作家mcp -Playwright MCP的替代Nix包装