MCP Playwright服务器

一个基于Playwright提供浏览器自动化能力的模型上下文协议服务器
_{使大语言模型能够与网页交互、截取屏幕截图并在真实浏览器环境中执行JavaScript}

目录

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

功能特性

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

安装

通过Smithery安装

要通过Smithery为Claude Desktop自动安装MCP 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": "截图名称",     // 必需
  "selector": "#元素ID",     // 可选
  "fullPage": true              // 可选，默认: false
}

browser_click

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

{
  "selector": "#按钮ID"
}

browser_click_text

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

{
  "text": "点击我"
}

browser_hover

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

{
  "selector": "#菜单项"
}

browser_hover_text

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

{
  "text": "悬停我"
}

browser_fill

填写输入字段

{
  "selector": "#输入字段",
  "value": "Hello World"
}

browser_select

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

{
  "selector": "#下拉框",
  "value": "选项值"
}

browser_select_text

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

{
  "text": "选择我",
  "value": "选项值"
}

browser_evaluate

在浏览器控制台中执行JavaScript

{
  "script": "document.title"
}

资源

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

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

2. 屏幕截图 (screenshot://<n>)

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

许可证

本项目采用MIT许可证 - 详情请参阅LICENSE文件。