Puppeteer

一个模型上下文协议（Model Context Protocol）服务器，提供使用 Puppeteer 的浏览器自动化能力。该服务器使 LLM 能够与网页交互、截取屏幕截图，并在真实的浏览器环境中执行 JavaScript。

组件

工具

• 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 执行
• 基本的 Web 交互（导航、点击、表单填写）

使用 Puppeteer 服务器的配置

以下是使用 Puppeteer 服务器的 Claude Desktop 配置：

Docker

注意 Docker 实现将使用无头 Chromium，而 NPX 版本将打开一个浏览器窗口。

{
  "mcpServers": {
    "puppeteer": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-e",
        "DOCKER_CONTAINER=true",
        "mcp/puppeteer"
      ]
    }
  }
}

NPX

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    }
  }
}

构建

Docker 构建:

docker build -t mcp/puppeteer -f src/puppeteer/Dockerfile .

许可证

此 MCP 服务器是在 MIT 许可证下授权的。 这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。 有关更多详细信息，请参阅项目存储库中的 LICENSE 文件。