Playwright MCP Server

Playwright MCP Server

site icon
2025.02.25 6
TypeScript网页自动化测试内容抓取交互模拟浏览器自动化开发效率
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 服务器前设置必要的环境变量
  • 检索网页内容时遵循目标网站的服务条款
  • 发送多个请求时保持适当的间隔
  • 执行鼠标操作时保持适当间隔,因为它们模拟实际用户交互

使用教程

使用依赖

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

安装教程

通过 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 开源许可条款。