FindMCP Logo FindMCP.info
MCP-Puppeteer-Linux

MCP-Puppeteer-Linux

site icon
2025.02.05 4
JavaScript浏览器自动化网页测试数据抓取浏览器自动化
MCP-Puppeteer-Linux 是一个基于 Model Context Protocol 的服务，提供浏览器自动化功能，使用 Puppeteer 并完全支持 Linux 显示服务器（X11 和 Wayland）。该服务使 LLMs 能够与网页交互、截图以及在真实浏览器环境中执行 JavaScript。
View on GitHub

Overview

基本能力

产品定位

MCP-Puppeteer-Linux 是一个浏览器自动化工具，专为 Linux 环境设计，支持 X11 和 Wayland 显示服务器。

核心功能

  • 浏览器自动化（导航、点击、表单填写等）
  • 自动检测和配置 Linux 显示服务器（X11/Wayland）
  • 控制台日志监控
  • 截图功能
  • JavaScript 执行
  • 基本网页交互（导航、点击、表单填写）

适用场景

  • 网页自动化测试
  • 网页数据抓取
  • 网页截图生成
  • 网页交互模拟
  • 浏览器环境下的 JavaScript 执行

工具列表

  • puppeteer_navigate: 导航到指定 URL
  • puppeteer_screenshot: 捕获整个页面或特定元素的截图
  • puppeteer_click: 点击页面上的元素
  • puppeteer_hover: 悬停在页面上的元素
  • puppeteer_fill: 填写输入字段
  • puppeteer_select: 选择 SELECT 标签的元素
  • puppeteer_evaluate: 在浏览器控制台中执行 JavaScript

常见问题解答

  • 支持哪些 Linux 显示服务器？
  • 支持 X11 和 Wayland，包括 XWayland 兼容性
  • 如何配置 Claude Desktop？
  • 通过 JSON 配置文件指定命令和参数

使用教程

使用依赖

  • Node.js 环境
  • npm 包管理器

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @PhialsBasement/mcp-puppeteer-linux --client claude

手动安装

  1. 克隆仓库:
git clone https://github.com/PhialsBasement/MCP-Puppeteer-Linux.git
  1. 安装依赖:
npm install
  1. 启动服务:
ts-node index.ts

调试方式

  • 检查显示服务器是否正确检测和配置
  • 验证浏览器是否能够正常启动和导航
  • 检查控制台日志是否有错误信息

许可证

该项目遵循 MIT 开源许可条款。