
Puppeteer-Extra MCP Server

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