local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Supports interaction with web elements using CSS selectors for operations like clicking, hovering, filling form fields, and capturing specific elements in screenshots.
Offers the ability to use Firefox instead of Chrome as the browser engine through custom Puppeteer configuration options.
Enables execution of JavaScript code in the browser context through the puppeteer_evaluate tool, allowing for dynamic interaction with web page content.

可配置的 Puppeteer MCP 服务器

一个模型上下文协议 (MLM) 服务器，使用 Puppeteer 提供浏览器自动化功能，并提供可配置选项。该服务器使 LLM 能够在真实的浏览器环境中与网页交互、截取屏幕截图和执行 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 代码

资源

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

控制台日志（ console://logs ）
- 浏览器控制台以文本格式输出
- 包括来自浏览器的所有控制台消息
屏幕截图（ 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}}"
      }
    }
  }
}

标准配置

NPX

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

您还可以指定分支、标签或提交：

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

执照

此 MCP 服务器采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

模型上下文协议服务器使用 Puppeteer 提供浏览器自动化功能，并通过环境变量提供可配置选项，使 LLM 能够在浏览器环境中与网页交互、截屏和执行 JavaScript。

Appeared in Searches

Tools and Extensions for Web Browsers