AI导哈

浏览器自动化工具

一个基于Puppeteer的浏览器自动化工具，支持Linux显示服务器（X11和Wayland），提供网页交互、截图和JavaScript执行功能。

  • by PhialsBasement
  • JavaScript
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 PhialsBasement/MCP-Puppeteer-Linux

使用说明

MCP木偶Linux

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

显示服务器支持

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

  • 自动X11/地面检测
  • 动态环境变量配置
  • 支持各种桌面环境（GNOME、KDE等）
  • 回退机制和强大的错误处理
  • XWayland兼容性

组件

工具

  • puppeteer_navigation
    • 导航到浏览器中的任何URL
    • 输入： url （字符串）
  • 木偶戏
    • 捕获整个页面或特定元素的屏幕截图
    • 输入：
      • name （string，必填）：屏幕截图的名称
      • selector （string，可选）：用于截图元素的CSS选择器
      • width （数字，可选，默认值：800）：截图宽度
      • height （数字，可选，默认值：600）：截图高度
  • 木偶戏
    • 点击页面上的元素
    • 输入： selector （string）：用于单击元素的CSS选择器
  • 木偶戏
    • 将元素悬停在页面上
    • 输入： selector （string）：用于悬停元素的CSS选择器
  • 木偶戏
    • 填写输入字段
    • 输入：
      • selector （string）：输入字段的CSS选择器
      • value （string）：要填充的值
  • 木偶师_选择
    • 选择带有Select标签的元素
    • 输入：
      • selector （string）：用于选择元素的CSS选择器
      • value （string）：要选择的值
  • 木偶师_评价
    • 在浏览器控制台中执行JavaScript
    • 输入： script （string）：要执行的JavaScript代码

资源

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

  1. 控制台日志 (console://logs)
    • 文本格式的浏览器控制台输出
    • 包括来自浏览器的所有控制台消息
  2. 截图 (screenshot://<name>)
    • 捕获的屏幕截图的PNG图像
    • 可通过捕获期间指定的屏幕截图名称访问

主要特点

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

配置

Claude桌面配置

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["ts-node", "/path/to/index.ts"]
    }
  }
}

安装

通过Smithery安装

通过以下方式自动安装Puppeteer Linux for Claude Desktop 史密瑟里:

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

显示服务器详细信息

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

Wayland支持

  • 通过以下方式检测Wayland会话 WAYLAND_DISPLAY
  • 配置必要的环境变量：
    • WAYLAND_DISPLAY
    • QT_QPA_PLATFORM
    • GDK_BACKEND
    • MOZ_ENABLE_WAYLAND
    • XDG_SESSION_TYPE

X11支持

  • 传统X11会话的回退
  • 处理X11特定变量：
    • DISPLAY
    • XAUTHORITY
  • 支持各种桌面环境和窗口管理器

许可证

此MCP服务器根据MIT许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息，请参阅项目存储库中的LICENSE文件。

相关 MCP