Puppeteer

Puppeteer

site icon
2025.02.15 0
JavaScript浏览器自动化网页测试网页抓取浏览器自动化
Mcp-Puppeteer-Server 是一个基于 Model Context Protocol 的服务,提供浏览器自动化能力,使用 Puppeteer 实现。该服务使 LLMs 能够与网页交互,包括截图、执行 JavaScript 代码以及在真实浏览器环境中进行基本网页操作。
View on GitHub

Overview

基本能力

产品定位

Mcp-Puppeteer-Server 是一个浏览器自动化服务,专为需要与网页交互的场景设计。

核心功能

  • 浏览器自动化:支持导航、点击、悬停、表单填写等基本网页交互。
  • 截图功能:可以捕获整个页面或特定元素的截图。
  • JavaScript 执行:在浏览器控制台中执行自定义 JavaScript 代码。
  • 控制台日志监控:提供浏览器控制台输出的访问。

适用场景

  • 网页自动化测试
  • 网页内容抓取
  • 自动化表单填写
  • 网页截图生成
  • 网页交互模拟

工具列表

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

常见问题解答

  • Docker 和 NPX 版本的区别:Docker 版本使用无头 Chromium,而 NPX 版本会打开浏览器窗口。

使用教程

使用依赖

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

安装教程

Docker 安装

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

NPX 安装

无需额外安装,直接通过 NPX 运行。

调试方式

  • 使用 Docker 运行:
docker run -i --rm --init -e DOCKER_CONTAINER=true mcp/puppeteer
  • 使用 NPX 运行:
npx -y @modelcontextprotocol/server-puppeteer

许可证

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