MCP Server Playwright

MCP Server Playwright

site icon
2025.05.12 0
JavaScript浏览器自动化网页交互自动化测试浏览器自动化
MCP Server Playwright 是一个基于 Model Context Protocol 的服务,提供浏览器自动化能力,使用 Playwright 实现。它允许大型语言模型(LLMs)与网页交互,包括截图、执行 JavaScript 等操作,适用于需要在真实浏览器环境中进行自动化测试和交互的场景。
View on GitHub

Overview

基本能力

产品定位

MCP Server Playwright 是一个浏览器自动化工具,专为需要与网页进行交互的应用场景设计,如自动化测试、数据抓取和网页内容生成等。

核心功能

  • 🌐 完整的浏览器自动化能力
  • 📸 捕获整个页面或特定元素的截图
  • ☁️ 可选将截图上传至 Imgur 并获取公开图片 URL
  • 🖱️ 全面的网页交互(导航、点击、表单填写)
  • 📊 控制台日志监控
  • 🔧 在浏览器上下文中执行 JavaScript

适用场景

  • 自动化测试
  • 网页数据抓取
  • 网页内容生成
  • 网页交互模拟

工具列表

  1. browser_navigate: 导航到任何 URL
  2. browser_screenshot: 捕获页面或元素的截图
  3. browser_click: 通过 CSS 选择器点击元素
  4. browser_click_text: 通过文本内容点击元素
  5. browser_hover: 通过 CSS 选择器悬停元素
  6. browser_hover_text: 通过文本内容悬停元素
  7. browser_fill: 填写输入字段
  8. browser_select: 通过 CSS 选择器选择下拉选项
  9. browser_select_text: 通过文本内容选择下拉选项
  10. browser_evaluate: 在浏览器控制台中执行 JavaScript

常见问题解答

  • 如何启用 Imgur 截图上传? 设置 IMGUR_CLIENT_ID 环境变量即可启用。
  • 截图如何返回? 如果未设置 IMGUR_CLIENT_ID,截图将以 base64 数据返回。

使用教程

使用依赖

无特殊前置依赖,直接安装即可。

安装教程

通过 Smithery 安装

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

通过 npx 安装

npx @automatalabs/mcp-server-playwright install

通过 mcp-get 安装

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

调试方式

安装完成后,可以通过以下命令启动服务:

npx @automatalabs/mcp-server-playwright

检查配置文件是否正确生成: - Windows: %APPDATA%\Claude\claude_desktop_config.json - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。