MCP-Puppeteer-Linux

一个模型上下文协议 (MLM) 服务器，使用 Puppeteer 提供浏览器自动化功能，并全面支持 Linux 显示服务器（X11 和 Wayland）。该服务器使 LLM 能够在真实的浏览器环境中与网页交互、截取屏幕截图并执行 JavaScript。

显示服务器支持

此分支添加了 Linux 显示服务器的自动检测和配置：

• 自动 X11/Wayland 检测

• 动态环境变量配置

• 支持各种桌面环境（GNOME、KDE等）

• 回退机制和强大的错误处理

• XWayland 兼容性

Related MCP server: mcp-server-browserbase

成分

工具

• 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 图像

   • 可通过捕获期间指定的屏幕截图名称访问

主要特点

• 具有 Linux 显示服务器支持的浏览器自动化

• 自动 X11/Wayland 检测和配置

• 控制台日志监控

• 截图功能

• JavaScript 执行

• 基本网络交互（导航、点击、表单填写）

配置

Claude桌面配置

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Puppeteer Linux：

手动安装

1. 克隆存储库：

2. 安装依赖项：

3. 启动服务器：

显示服务器详细信息

服务器自动检测并配置适当的显示环境：

Wayland 支持

• 通过WAYLAND_DISPLAY检测 Wayland 会话

• 配置必要的环境变量：

  • WAYLAND_DISPLAY

  • QT_QPA_PLATFORM

  • GDK_BACKEND

  • MOZ_ENABLE_WAYLAND

  • XDG_SESSION_TYPE

X11 支持

• 传统 X11 会话的回退

• 处理 X11 特定的变量：

  • DISPLAY

  • XAUTHORITY

• 支持各种桌面环境和窗口管理器

执照

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