JinDaGe - Puppeteer Extra Stealth MCP Details

article

README

🚀 Puppeteer-Extra MCP 服务器

Puppeteer-Extra MCP 服务器是一个运用 Puppeteer-Extra 与 Stealth 插件来增强浏览器自动化能力的模型上下文协议（Model Context Protocol）服务器。它能让大语言模型（LLM）以更接近人类的行为方式与网页交互，有效避免被识别为自动化程序。

✨ 主要特性

借助 Puppeteer-Extra 实现增强型浏览器自动化。
通过 Stealth 模式规避机器人检测。
提供页面和元素的截图功能。
支持浏览器控制台日志记录与 JavaScript 代码执行。
具备全方位的交互方法，如点击、填充、选择、悬停等。

📦 安装指南

克隆仓库并安装依赖

# 克隆仓库
git clone <仓库地址>
cd puppeteer_extra

# 安装依赖项
npm install

# 复制环境文件
cp .env.example .env.development

本地运行

# 开发模式（非无头浏览器）
npm run dev

# 生产模式（无头浏览器）
npm run prod

构建项目

npm run build

构建 Docker 镜像

docker build -t mcp/puppeteer-extra .

使用 Docker 运行

docker run -i --rm --init -e DOCKER_CONTAINER=true mcp/puppeteer-extra

📚 详细文档

工具

| 工具名称 | 功能 | 输入参数 | | ---- | ---- | ---- | | puppeteer_navigate | 浏览器中导航至任意 URL | url (字符串) | | puppeteer_screenshot | 捕获页面或特定元素的截图 | name (字符串，必填)：截图名称
selector (字符串，可选)：CSS 选择器（用于元素截图）
width (数字，可选，默认值：800)：截图宽度
height (数字，可选，默认值：600)：截图高度 | | puppeteer_click | 点击页面上的元素 | selector (字符串)：待点击的元素选择器 | | puppeteer_hover | 悬停在页面上的元素上 | selector (字符串)：待悬停的元素选择器 | | puppeteer_fill | 填充输入字段内容 | selector (字符串)：输入框选择器
value (字符串)：填充的内容 | | puppeteer_select | 选择带有 SELECT 标签的元素 | selector (字符串)：待选择的元素选择器
value (字符串)：选择的值 | | puppeteer_evaluate | 在浏览器控制台中执行 JavaScript 代码 | script (字符串)：待执行的 JavaScript 脚本 |

资源

服务器提供两种类型的资源访问：

控制台日志 (console://logs)：包含浏览器控制台输出的所有文本信息。
截图 (screenshot://<名称>)：页面或元素的 PNG 格式截图图像，可通过截图时指定的名称访问。

配置（适用于 Claude Desktop）

Docker 配置

{
  "mcpServers": {
    "puppeteer": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--init", "-e", "DOCKER_CONTAINER=true", "mcp/puppeteer-extra"]
    }
  }
}

NPX 配置

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "MCP_puppeteer_extra"]
    }
  }
}

📄 许可证

此 MCP 服务器采用 MIT License 开源协议进行许可。

Puppeteer Extra Stealth