Playwright MCP Server

Playwright MCP Server

site icon
2025.02.25 0
网页内容检索浏览器自动化浏览器自动化
Playwright MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,提供 Playwright 网页内容检索功能。它支持页面导航、内容检索、交互元素检测以及鼠标操作模拟等功能,适用于需要自动化浏览器操作的场景。
View on GitHub

Overview

基本能力

产品定位

Playwright MCP Server 是一个提供网页内容检索和浏览器自动化操作的服务,适用于开发测试、数据抓取和自动化任务等场景。

核心功能

  • 页面导航
  • 全页面内容检索
  • 可见内容检索
  • 交互元素检测
  • 鼠标操作模拟(移动、点击、滚动、拖放)
  • 测试用的回显功能

适用场景

  • 自动化测试
  • 网页内容抓取
  • 交互式网页操作模拟
  • 开发调试

工具列表

  1. navigate - 导航到指定 URL
  2. get_all_content - 检索整个页面的内容
  3. get_visible_content - 检索当前可见内容
  4. get_interactive_elements - 获取页面交互元素的位置信息
  5. move_mouse - 移动鼠标到指定坐标
  6. mouse_click - 在指定坐标执行鼠标点击
  7. mouse_wheel - 执行鼠标滚轮滚动
  8. drag_and_drop - 执行拖放操作
  9. echo - 测试用的回显工具

常见问题解答

  • 确保在使用 MCP 服务器前设置了必要的环境变量
  • 遵守目标网站的服务条款
  • 发送多个请求时保持适当的间隔
  • 执行鼠标操作时保持适当间隔以模拟真实用户交互

使用教程

使用依赖

需要安装 Node.js 和 npm。

安装教程

通过 Smithery 安装

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

手动安装

npm install

启动服务器

npm run build
npm start

调试方式

# 运行所有测试
npm test

# 在监视模式下运行测试
npm run test:watch

# 生成覆盖率报告
npm run test:coverage

许可证

该项目遵循 ISC 开源许可条款。