网页自动化助手

@Automata-Labs-team/MCP-Server-Playwright
4 Stars 966 次浏览 Automata-Labs-team 更新于 2026-08-23

使大型语言模型(LLMs)能够与网页交互、截屏以及在真实的浏览器环境中执行JavaScript。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

可用工具 (10 个)

该服务在 MCP 协议中暴露的工具,AI 可按需调用

browser_navigate 1 个参数 需填 1 项

Navigate to a URL

必填参数:url

browser_screenshot 3 个参数 需填 1 项

Take a screenshot of the current page or a specific element

必填参数:name

browser_click 1 个参数 需填 1 项

Click an element on the page using CSS selector

必填参数:selector

browser_click_text 1 个参数 需填 1 项

Click an element on the page by its text content

必填参数:text

browser_fill 2 个参数 需填 2 项

Fill out an input field

必填参数:selector、value

browser_select 2 个参数 需填 2 项

Select an element on the page with Select tag using CSS selector

必填参数:selector、value

browser_select_text 2 个参数 需填 2 项

Select an element on the page with Select tag by its text content

必填参数:text、value

browser_hover 1 个参数 需填 1 项

Hover an element on the page using CSS selector

必填参数:selector

browser_hover_text 1 个参数 需填 1 项

Hover an element on the page by its text content

必填参数:text

browser_evaluate 1 个参数 需填 1 项

Execute JavaScript in the browser console

必填参数:script

服务介绍

目录

特性

  • 🌐 完整的浏览器自动化功能
  • 📸 截取整个页面或特定元素的屏幕截图
  • 🖱️ 全面的网页交互(导航、点击、表单填写)
  • 📊 控制台日志监控
  • 🔧 在浏览器上下文中执行 JavaScript 代码

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 MCP Server Playwright:

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

你可以使用 npx 或 mcp-get 来安装该包:

使用 npx:

npx @automatalabs/mcp-server-playwright install

此命令将:

  1. 检查你的操作系统兼容性(Windows/macOS)
  2. 创建或更新 Claude 配置文件
  3. 配置 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",     // required
  "selector": "#element-id",     // optional
  "fullPage": true              // optional, default: 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

使用CSS选择器在一个SELECT元素中选择一个选项

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

browser_select_text

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

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

browser_evaluate

在浏览器控制台执行JavaScript代码

{
  "script": "document.title"
}

资源

  1. 控制台日志 (console://logs)

    • 以文本格式访问浏览器控制台输出
    • 包括来自浏览器的所有控制台消息
  2. 屏幕截图 (screenshot://<n>)

    • 访问捕获的屏幕截图的PNG图像
    • 通过捕获时指定的名称引用

许可证

本项目根据MIT许可证发布 - 详情请参阅LICENSE文件。

相关 MCP 服务