MCP-Server-Playwright

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Allows execution of JavaScript in the browser environment via the browser_evaluate tool

  • Supports macOS as a compatible operating system with specific configuration paths

目录

特征

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

使 LLM 能够在真实的浏览器环境中与网页交互、截取屏幕截图和执行 JavaScript

  1. Features
    1. Installation
      1. Installing via Smithery
    2. Configuration
      1. Components
        1. Tools
        2. Resources
      2. License
        ID: 9q4zck8po5