浏览器自动化服务

一个基于Playwright的浏览器自动化服务,提供页面导航、元素交互、截图和PDF生成等功能。

  • by rcrumpto14
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 rcrumpto14/playwright-mcp-server

使用说明

剧作家MCP服务器

使用Playwright提供浏览器自动化功能的模型上下文协议(MCP)服务器。

特性

  • 浏览器管理(启动、关闭)
  • 页面导航
  • 元素交互(点击、键入、获取文本)
  • 等待元素
  • 屏幕截图
  • PDF生成
  • 无头和有头浏览器模式

安装

npm install
npm run build

用法

作为MCP服务器

添加到您的MCP配置文件中(例如。, ~/.cursor/mcp.json):

{
  "servers": {
    "playwright": {
      "command": "node",
      "args": ["path/to/playwright-mcp-server/dist/index.js"]
    }
  }
}

如果发布到npm:

{
  "servers": {
    "playwright": {
      "command": "npx",
      "args": ["playwright-mcp-server"]
    }
  }
}

发展

npm run dev

可用工具

browser_launch

启动一个新的浏览器实例。

  • headless (boolean,可选):在无头模式下运行(默认值:true)

navigate

导航到URL。

  • url (字符串,必填):要导航到的URL

click

单击一个元素。

  • selector (string,必填):元素的CSS选择器

type

在输入框中键入文本。

  • selector (string,必填):输入字段的CSS选择器
  • text (字符串,必填):要键入的文本

get_text

从元素中获取文本内容。

  • selector (string,必填):元素的CSS选择器

screenshot

截取当前页面的屏幕截图。

  • path (string,必填):保存截图的文件路径
  • fullPage (布尔值,可选):捕获整页(默认值:false)

generate_pdf

生成当前页面的PDF。

  • path (字符串,必填):保存PDF的文件路径
  • format (字符串,可选):纸张格式(默认:A4)

wait_for_selector

等待元素出现。

  • selector (string,必填):要等待的CSS选择器
  • timeout (数字,可选):超时时间(毫秒)(默认值:30000)

browser_close

关闭浏览器实例。

示例用法

  1. 启动浏览器: browser_launch
  2. 导航到页面: navigate 带有URL
  3. 与元素交互: click, type, get_text
  4. 捕获内容: screenshot 或 generate_pdf
  5. 关闭浏览器: browser_close

许可证

麻省理工学院