木偶师服务器

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

组件

工具

• puppeteer_navigate

  • 功能：导航到任意URL
  • 输入参数：url（字符串）

• puppeteer_screenshot

  • 功能：截取网页或特定元素的屏幕截图
  • 输入参数：
    • name（字符串，必填）：屏幕截图名称
    • selector（字符串，可选）：用于筛选元素的CSS选择器
    • width（数字，可选，默认值：800）：屏幕截图宽度
    • height（数字，可选，默认值：600）：屏幕截图高度

• puppeteer_click

  • 功能：点击页面上的元素
  • 输入参数：selector（字符串）：要点击的元素的选择器

• puppeteer_hover

  • 功能：悬停在页面上的某个元素上
  • 输入参数：selector（字符串）：要悬停的元素的选择器

• puppeteer_fill

  • 功能：填写表单字段
  • 输入参数：
    • selector（字符串）：表单字段选择器
    • value（字符串）：要填入的内容

• puppeteer_select

  • 功能：从下拉列表中选择元素
  • 输入参数：
    • selector（字符串）：下拉列表的选择器
    • value（字符串）：要选择的值

• puppeteer_evaluate

  • 功能：在浏览器控制台执行JavaScript代码
  • 输入参数：script（字符串）：要执行的JavaScript代码

资源

此服务器提供两种类型的资源：

1. 控制台日志 (console://logs)

   • 浏览器控制台输出文本信息
   • 包含浏览器的所有控制台消息

2. 屏幕截图 (screenshot://<name>)

   • PNG格式的页面截图
   • 通过截取时指定的名称访问屏幕截图

核心功能

• 浏览器自动化操作
• 控制台日志监控
• 屏幕截图功能
• JavaScript代码执行
• 基本网页交互（导航、点击、表单填写）

使用Puppeteer服务器的配置方法

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

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 License授权。这意味着您可以在任何用途中免费使用、修改和分发软件，但需遵守MIT License的条款和条件。有关详细信息，请参阅项目仓库中的LICENSE文件。