AI导哈

浏览器自动化服务器

一个基于Puppeteer-Extra和Stealth插件的浏览器自动化服务器，提供增强的网页交互能力，模拟人类行为并避免被检测为自动化工具。

  • by gpaul-faldin
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 gpaul-faldin/MCP_puppeteer_extra

使用说明

Puppeter额外MCP服务器

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

特性

  • 使用Puppeter Extra增强浏览器自动化
  • 隐形模式，避免机器人检测
  • 页面和元素的截图功能
  • 控制台日志记录和JavaScript执行
  • 全套交互方法（点击、填充、选择、悬停）

组件

工具

  • puppeteer_navigation

    • 导航到浏览器中的任何URL
    • 输入： url （字符串）

  • 木偶戏

    • 捕获整个页面或特定元素的屏幕截图
    • 输入：
      • name （string，必填）：屏幕截图的名称
      • selector （string，可选）：用于截图元素的CSS选择器
      • width （数字，可选，默认值：800）：截图宽度
      • height （数字，可选，默认值：600）：截图高度

  • 木偶戏

    • 点击页面上的元素
    • 输入： selector （string）：用于单击元素的CSS选择器

  • 木偶戏

    • 将元素悬停在页面上
    • 输入： selector （string）：用于悬停元素的CSS选择器

  • 木偶戏

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

  • 木偶师_选择

    • 选择带有Select标签的元素
    • 输入：
      • selector （string）：用于选择元素的CSS选择器
      • value （string）：要选择的值

  • 木偶师_评价

    • 在浏览器控制台中执行JavaScript
    • 输入： script （string）：要执行的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 build -t mcp/puppeteer-extra .

使用Docker运行

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

Claude桌面配置

码头工人

{
  "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许可证获得许可。

相关 MCP