Puppeteer-Extra MCP Server

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)

- 文本格式的浏览器控制台输出 - 包括来自浏览器的所有控制台消息

1. 截图 (screenshot://)

- 捕获的屏幕截图的PNG图像 - 可通过捕获期间指定的屏幕截图名称访问

发展

安装

# Clone the repository
git clone 
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许可证获得许可。