Puppeteer MCP Server

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Enables interaction with web page elements through CSS selectors for actions like clicking, hovering, and capturing screenshots of specific elements

  • Allows executing JavaScript code in the browser console using the puppeteer_evaluate tool

  • Provides browser automation capabilities using Puppeteer, enabling LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment

木偶师

一个使用 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 执行
  • 基本网络交互(导航、点击、表单填写)

配置使用 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 文件。

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

使 LLM 能够执行网页浏览任务、截取屏幕截图以及使用 Puppeteer 执行 JavaScript 以实现浏览器自动化。

  1. Components
    1. Tools
    2. Resources
  2. Key Features
    1. Configuration to use Puppeteer Server
      1. Docker
      2. NPX
    2. Build
      1. License
        ID: anvpl8ffa6