puppeteer-mcp-server

概述

该 Puppeteer MCP 服务器通过模型上下文协议提供了包含 16 个工具的完整浏览器自动化套件。它包含核心浏览器导航工具、高级鼠标交互功能和用于身份验证处理的 cookie 管理。服务器同时支持现代可流式传输的 HTTP 方式和传统的 SSE 传输方式，并通过 API 密钥进行身份验证验证。该服务器已投入生产使用，支持 Docker 部署，具备限流、健康监控和全面的日志记录功能。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• puppeteer_navigate

  Navigate to URLs with safety validation

  试试:Navigate to https://example.com试试:Go to the Google homepage
• puppeteer_screenshot

  Take full page or element screenshots

  试试:Take a screenshot of the current page试试:Capture a screenshot of the login button
• puppeteer_click

  Click elements with retry logic

  试试:Click the submit button试试:Click the download link with id 'download-btn'
• puppeteer_fill

  Fill input fields with validation

  试试:Fill in the username field with 'john_doe'试试:Enter 'password123' in the password input
• puppeteer_select

  Select options from dropdown elements

  试试:Select 'United States' from the country dropdown试试:Choose the 'Premium' option from the plan selector
• puppeteer_hover

  Hover over elements with effect detection

  试试:Hover over the menu item试试:Move the mouse over the interactive element
• puppeteer_evaluate

  Execute JavaScript with console capture

  试试:Run document.querySelector('h1').textContent试试:Get all links on the page
• puppeteer_mouse_move

  Precise coordinate movement with smooth interpolation

  试试:Move the mouse to coordinates x:300, y:200试试:Smoothly move to position 500, 400 in 10 steps
• puppeteer_mouse_click

  Advanced clicking with button options (left/right/middle/back/forward)

  试试:Right-click at coordinates 400, 300试试:Double-click the submit button
• puppeteer_mouse_down

  Mouse button press for drag operations

  试试:Press the left mouse button at position 200, 150试试:Hold down the right mouse button
• puppeteer_mouse_up

  Mouse button release for drag operations

  试试:Release the left mouse button at position 250, 200试试:Let go of the right mouse button
• puppeteer_mouse_wheel

  Mouse wheel scrolling with deltaX/deltaY control

  试试:Scroll down by 120 pixels试试:Scroll horizontally with deltaX: -50, deltaY: 0

可对比工具

安装

# 克隆仓库
git clone https://github.com/sultannaufal/puppeteer-mcp-server.git
cd puppeteer-mcp-server

# 创建包含 API 密钥的 .env 文件
echo "API_KEY=your-secure-api-key-here" > .env

# 使用 Docker Compose 启动
docker compose --env-file .env up -d

# 前置条件：Node.js 18+，npm 8+
npm install
npm run build
npm start

{
  "mcpServers": {
    "puppeteer": {
      "command": "node",
      "args": ["dist/server.js"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

FAQ

如何与服务器进行身份验证？

所有端点都需要 Bearer 令牌身份验证。设置您的 API_KEY 环境变量，并在请求中包含 'Authorization: Bearer your-api-key'。

支持哪些传输协议？

服务器同时支持现代可流式传输的 HTTP 方式（MCP 2025-06-18 规范）和传统的 SSE 传输，以确保向后兼容性。

puppeteer-mcp-server 对比