Puppeteer

Puppeteer

site icon
2025.01.14 1
JavaScript浏览器自动化网页交互网页截图浏览器自动化
mcp-scrape-copilot 是一个基于 Puppeteer 的 MCP 协议服务器,提供浏览器自动化能力。它允许 LLMs(大型语言模型)与网页进行交互,包括导航、截图、执行 JavaScript 脚本以及基本的网页操作(如点击、悬停、填写表单等)。该服务适用于需要自动化网页操作、监控控制台日志或捕获网页截图的场景。
View on GitHub

Overview

基本能力

产品定位

mcp-scrape-copilot 是一个浏览器自动化工具,旨在通过 Puppeteer 提供网页交互和自动化能力。

核心功能

  • 浏览器自动化:包括导航到指定 URL、点击元素、悬停元素等。
  • 截图功能:可以捕获整个页面或特定元素的截图。
  • JavaScript 执行:在浏览器控制台中执行自定义 JavaScript 代码。
  • 控制台日志监控:实时获取浏览器控制台的输出信息。
  • 表单操作:支持填写表单字段和选择下拉选项。

适用场景

  • 网页自动化测试
  • 网页内容抓取
  • 网页截图生成
  • 网页交互模拟
  • 控制台日志监控

工具列表

  • puppeteer_navigate:导航到指定 URL。
  • puppeteer_screenshot:捕获页面或元素的截图。
  • puppeteer_click:点击页面上的元素。
  • puppeteer_hover:悬停在页面上的元素。
  • puppeteer_fill:填写表单字段。
  • puppeteer_select:选择下拉选项。
  • puppeteer_evaluate:在浏览器控制台中执行 JavaScript 代码。

常见问题解答

  • 如何安装? 提供了 Docker 和 NPX 两种安装方式。
  • Docker 和 NPX 版本有什么区别? Docker 版本使用无头 Chromium,而 NPX 版本会打开浏览器窗口。

使用教程

使用依赖

  • 确保已安装 Docker 或 Node.js(用于 NPX 安装)。

安装教程

Docker 安装

docker build -t mcp/puppeteer -f src/puppeteer/Dockerfile .

NPX 安装

npx -y @modelcontextprotocol/server-puppeteer

调试方式

  • 使用 puppeteer_navigate 导航到目标 URL,然后使用其他工具进行交互或截图。
  • 监控 console://logs 资源以查看控制台输出。
  • 通过 screenshot://<name> 资源访问捕获的截图。

许可证

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