Puppeteer

这是一个使用Puppeteer提供浏览器自动化功能的Model Context Protocol服务器。该服务器使LLMs能够与网页进行交互、截取屏幕快照并在真实的浏览器环境中执行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执行
• 基本的网页交互（导航、点击、表单填写）

配置以使用Puppeteer服务器

这是使用Puppeter服务器的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文件。