Puppeteer-Extra MCP Server

Puppeteer-Extra MCP Server

site icon
2025.03.20 1
TypeScript浏览器自动化浏览器自动化
Puppeteer-Extra MCP Server 是一个基于 Model Context Protocol 的服务,通过 Puppeteer-Extra 和 Stealth 插件提供增强的浏览器自动化能力。该服务使 LLMs 能够以更接近人类行为的方式与网页交互,并避免被检测为自动化工具。
View on GitHub

Overview

基本能力

产品定位

Puppeteer-Extra MCP Server 是一个专注于浏览器自动化的服务,旨在模拟人类行为进行网页交互,避免被检测为自动化工具。

核心功能

  • 使用 Puppeteer-Extra 进行增强的浏览器自动化
  • 隐身模式以避免机器人检测
  • 页面和元素的截图功能
  • 控制台日志记录和 JavaScript 执行
  • 完整的交互方法(点击、填写、选择、悬停)

适用场景

  • 网页自动化测试
  • 数据抓取和爬虫
  • 网页内容截图
  • 自动化表单填写
  • 网页交互模拟

工具列表

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

常见问题解答

  • 如何避免被检测为自动化工具? 使用 Stealth 插件和隐身模式。
  • 如何获取截图? 使用 puppeteer_screenshot 工具并指定名称和可选的选择器。

使用教程

使用依赖

确保已安装 Node.js 和 npm。

安装教程

# Clone the repository
git clone <repository-url>
cd puppeteer_extra

# Install dependencies
npm install

# Copy environment file
cp .env.example .env.development

调试方式

# Development mode (non-headless browser)
npm run dev

# Production mode (headless browser)
npm run prod

Docker 使用

# Building the Docker Image
docker build -t mcp/puppeteer-extra .

# Running with Docker
docker run -i --rm --init -e DOCKER_CONTAINER=true mcp/puppeteer-extra

许可证

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