可配置 Puppeteer MCP 服务器

一个使用 Puppeteer 实现浏览器自动化能力的 Model Context Protocol 服务器，并提供可配置选项。此服务器使大语言模型能够与网页交互、截取屏幕截图并执行 JavaScript，能够在真实浏览器环境中运行，并支持通过环境变量自定义 Puppeteer 启动选项。

组件

工具

• 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 格式的页面截图
   • 通过截取时指定的屏幕截图名称访问

关键功能

• 浏览器自动化
• 控制台日志监控
• 屏幕截图能力
• JavaScript 执行
• 基本网页交互（导航、点击、表单填充）
• 通过环境变量配置 Puppeteer 选项

配置

使用自定义 Puppeteer 选项

您可以通过在 PUPPETEER_ARGS 环境变量中提供一个 JSON 字符串来配置 Puppeteer 启动选项。这样可以在不修改服务器代码的情况下自定义浏览器行为。

示例：使用 Firefox 而不是 Chrome

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer"],
      "env": {
        "PUPPETEER_ARGS": "{\"browser\": \"firefox\"}"
      }
    }
  }
}

示例：配置浏览器窗口大小

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer"],
      "env": {
        "PUPPETEER_ARGS": "{\"defaultViewport\": {\"width\": 1280, \"height\": 800}}"
      }
    }
  }
}

标准配置

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer"]
    }
  }
}

许可证

此项目采用 MIT 许可证。