JinDaGe - mcp-server-playwright-hdj MCP Details

article

README

🚀 MCP 服务器 Playwright

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 格式的捕获截图
通过捕获时指定的名称引用

📄 许可证

文档中未提及具体许可证信息，若有相关信息可补充至此。

mcp-server-playwright-hdj