Puppeteer Extra Stealth

🚀 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

Docker 镜像构建

docker build -t mcp/puppeteer-extra .

💻 使用示例

本地运行

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

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

Docker 运行

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

构建项目

npm run build

📚 详细文档

工具

资源

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

1. 控制台日志 (console://logs)：浏览器控制台输出的文本信息，包括所有来自浏览器的控制台消息。
2. 截图 (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 开源协议进行许可。