Puppeteer-Extra MCP 服务器

一个模型上下文协议（Model Context Protocol，MCP）服务器，它使用带有 Stealth 插件的 Puppeteer-Extra 提供增强的浏览器自动化功能。该服务器使 LLM 能够以更好地模拟人类行为的方式与网页交互，并避免被检测为自动化程序。

功能

• 使用 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 图像
   • 可通过捕获期间指定的屏幕截图名称访问

开发

安装

# 克隆仓库
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", "MCP_puppeteer_extra"]
    }
  }
}

许可证

此 MCP 服务器在 MIT 许可证下获得许可。