Puppeteer-Extra MCP Server

Puppeteer-Extra MCP 服务

一个模型上下文协议服务，使用 Puppeteer-Extra 和 Stealth Plugin 提供增强的浏览器自动化能力。此服务可让大模型与网页交互，更好地模拟人类行为并避免被检测为自动化操作。

功能

• 使用 Puppeteer-Extra 增强浏览器自动化
• 隐身模式，避免被检测为机器人
• 截取网页和元素的屏幕截图
• 控制台日志记录和 JavaScript 执行
• 完整的交互方法套件（点击、填写、选择、悬停）

组件

工具

• puppeteer_navigate

  • 在浏览器中导航至任意 URL
  • 输入：url（字符串）

• puppeteer_screenshot

  • 截取整个网页或特定元素的屏幕截图
  • 输入：
    • name（字符串，必填）：屏幕截图名称
    • selector（字符串，可选）：要截取屏幕截图的元素的 CSS 选择器
    • width（数字，可选，默认值：800）：屏幕截图宽度
    • height（数字，可选，默认值：600）：屏幕截图高度

• puppeteer_click

  • 点击网页上的元素
  • 输入：selector（字符串）：要点击的元素的 CSS 选择器

• puppeteer_hover

  • 将鼠标悬停在网页上的元素上
  • 输入：selector（字符串）：要悬停的元素的 CSS 选择器

• puppeteer_fill

  • 填写输入字段
  • 输入：
    • selector（字符串）：输入字段的 CSS 选择器
    • value（字符串）：要填写的值

• puppeteer_select

  • 选择带有 SELECT 标签的元素
  • 输入：
    • selector（字符串）：要选择的元素的 CSS 选择器
    • value（字符串）：要选择的值

• puppeteer_evaluate

  • 在浏览器控制台中执行 JavaScript
  • 输入：script（字符串）：要执行的 JavaScript 代码

资源

该服务提供两种类型的资源：

1. 控制台日志（console://logs）

   • 浏览器控制台的文本输出
   • 包含浏览器中的所有控制台消息

2. 屏幕截图（screenshot://<name>）

   • 已截取屏幕截图的 PNG 图像
   • 可通过截取时指定的屏幕截图名称访问

开发

安装

# 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

构建

npm run build

Docker

构建 Docker 镜像

docker build -t mcp/puppeteer-extra .

使用 Docker 运行

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

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 许可证。