MCP Puppeteer Extra

🚀 Puppeteer-Extra MCP 服务器

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

🚀 快速开始

Puppeteer-Extra MCP 服务器利用 Puppeteer-Extra 和 Stealth 插件，为大型语言模型提供了更强大的浏览器自动化交互能力。以下是启动服务器的基本步骤，你可以根据自己的需求选择合适的方式运行。

✨ 主要特性

• 增强型浏览器自动化功能：大幅提升浏览器自动化操作的能力。
• Stealth 模式防检测：通过 Stealth 模式，有效避免被反爬虫机制识别。
• 截图功能：支持对页面或元素进行截图。
• 控制台日志与 JS 执行：可记录浏览器控制台日志，并执行 JavaScript 代码。
• 全套互动方法：提供点击、填写、选择、悬停等多种交互操作。

📦 安装指南

克隆仓库并安装依赖

# 克隆仓库
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

💻 使用示例

工具使用

puppeteer_navigate

# 导航到任意URL
puppeteer_navigate('https://example.com')

此工具用于导航到指定的 URL，输入参数为要访问的 URL 字符串。

puppeteer_screenshot

# 截取页面或元素的屏幕截图
puppeteer_screenshot({
  "name": "example_screenshot",
  "selector": ".example-class",
  "width": 800,
  "height": 600
})

该工具用于截取页面或元素的屏幕截图，需要提供截图名称，可选择指定元素选择器、截图宽度和高度。

puppeteer_click

# 点击页面上的元素
puppeteer_click('.example-button')

此工具用于点击页面上指定选择器的元素。

puppeteer_hover

# 悬停在页面上的元素上
puppeteer_hover('.example-element')

该工具用于将鼠标悬停在页面上指定选择器的元素上。

puppeteer_fill

# 填写输入字段
puppeteer_fill({
  "selector": ".example-input",
  "value": "example text"
})

该工具用于在指定选择器的输入字段中填写内容。

puppeteer_select

# 在SELECT标签中选择元素
puppeteer_select({
  "selector": ".example-select",
  "value": "option1"
})

此工具用于在 SELECT 标签中选择指定的值。

puppeteer_evaluate

# 在浏览器控制台执行JavaScript代码
puppeteer_evaluate('console.log("Hello, World!")')

该工具用于在浏览器控制台执行 JavaScript 代码。

资源访问

控制台日志

服务器提供了对控制台日志的访问，可通过 console://logs 获取浏览器控制台输出的文本格式信息，其中包含所有浏览器控制台消息。

截图

可通过 screenshot://<name> 访问捕获的页面元素的 PNG 图像，其中 <name> 为指定的截图名称。

📚 详细文档

配置（适用于 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"]
    }
  }
}

📄 许可证

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