MCP 服务器 Playwright

目录

• 功能
• 安装
• 配置
• 组件
• 工具
• 资源
• 许可证

功能

• 🌐 全浏览器自动化能力
• 📸 页面或特定元素的截图捕获
• 🖱️ 全面的网页交互（导航、点击、表单填写）
• 📊 控制台日志监控
• 🔧 浏览器上下文中的JavaScript执行

安装

通过 Smithery 安装

通过 Smithery 自动为 Claude 桌面安装 MCP Server Playwright：

npx -y @smithery/cli install @automatalabs/mcp-server-playwright --client claude

您可以通过 npx 或 mcp-get 进行安装：

使用 npx:

npx @automatalabs/mcp-server-playwright install

此命令将：

• 检查您的操作系统兼容性（Windows/macOS）
• 创建或更新 Claude 配置文件
• 配置 Playwright 服务器集成

配置文件将自动创建/更新为：

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

使用 mcp-get:

npx @michaellatman/mcp-get@latest install @automatalabs/mcp-server-playwright

配置

安装过程会自动将以下配置添加到您的 Claude 配置文件中：

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@automatalabs/mcp-server-playwright"]
    }
  }
}

组件

工具

browser_navigate

导航到任意 URL

{
  "url": "https://stealthbrowser.cloud"
}

browser_screenshot

捕获页面或特定元素的截图

{
  "name": "screenshot-name",     // 必填
  "selector": "#element-id",     // 可选
  "fullPage": true              // 可选，默认：false
}

browser_click

使用 CSS 选择器点击页面上的元素

{
  "selector": "#button-id"
}

browser_click_text

通过文本内容点击页面上的元素

{
  "text": "Click me"
}

browser_hover

悬停在页面上的元素上（使用 CSS 选择器）

{
  "selector": "#menu-item"
}

browser_hover_text

通过文本内容悬停在页面上的元素上

{
  "text": "Hover me"
}

browser_fill

填写表单字段

{
  "selector": "#input-field",
  "value": "Hello World"
}

browser_select

在 SELECT 元素中选择选项（使用 CSS 选择器）

{
  "selector": "#dropdown",
  "value": "option-value"
}

browser_select_text

通过文本内容在 SELECT 元素中选择选项

{
  "text": "Choose me",
  "value": "option-value"
}

browser_evaluate

在浏览器控制台中执行 JavaScript

{
  "script": "document.title"
}

资源

控制台日志（console://logs）

• 以文本格式访问浏览器控制台输出
• 包括来自浏览器的所有控制台消息

屏幕截图（screenshot://）

• 访问 PNG 格式的捕获截图
• 通过捕获时指定的名称引用