Puppeteer-Extra MCP 服务器

一个使用Puppeteer-Extra和Stealth插件增强浏览器自动化能力的模型上下文协议（Model Context Protocol）服务器。此服务器使大型语言模型能够以更贴近人类行为的方式与网页交互，并避免被识别为自动化的操作。

功能

• 增强型浏览器自动化功能
• 通过Stealth模式避免被反-bot检测
• 页面和元素的截图功能
• 浏览器控制台日志记录和JavaScript执行
• 全套互动方法（点击、填写、选择、悬停）

组件

工具

• 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脚本

资源

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

1. 控制台日志 (console://logs)

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

2. 截图 (screenshot://<name>)

   • 捕获页面元素的PNG图像
   • 可通过指定的截图名称访问

开发

安装

# 克隆仓库
git clone <repository-url>
cd puppeteer_extra

# 安装依赖项
npm install

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

本地运行

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

# 生产模式（无头浏览器）
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", "MCPuppeteerExtra"]
    }
  }
}

许可证

[此处应添加具体的许可证信息]