MCP Puppeteer Linux

🚀 MCP-Puppeteer-Linux

MCP-Puppeteer-Linux是一个模型上下文协议服务器，它借助Puppeteer实现浏览器自动化功能，并且全面支持Linux显示服务器（X11和Wayland）。该服务器能让LLM在真实浏览器环境中与网页交互、截取屏幕截图以及执行JavaScript代码。

🚀 快速开始

安装与运行

1. 首先安装依赖：

npm install puppeteer

2. 创建配置文件并启动服务。

✨ 主要特性

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

📦 安装指南

依赖安装

npm install puppeteer

配置启动

创建配置文件并启动服务。以Claude Desktop为例，配置如下：

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

💻 使用示例

基础用法

以下是使用puppeteer_navigate工具在浏览器中导航到指定URL的示例：

# 假设存在调用工具的函数
puppeteer_navigate(url="https://example.com")

高级用法

以下是一个综合使用多个工具的示例，包括导航、填充表单、点击按钮和截取屏幕截图：

# 导航到页面
puppeteer_navigate(url="https://example.com/login")
# 填充用户名和密码
puppeteer_fill(selector="#username", value="your_username")
puppeteer_fill(selector="#password", value="your_password")
# 点击登录按钮
puppeteer_click(selector="#login-button")
# 截取登录结果页面的屏幕截图
puppeteer_screenshot(name="login_result", width=1200, height=800)

📚 详细文档

显示服务器支持

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

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

组件

工具

资源

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

1. 控制台日志（console://logs）
   • 浏览器控制台输出文本格式
   • 包括浏览器中的所有控制台消息
2. 屏幕截图（screenshot://<name>）
   • 按名称指定的截图PNG图像
   • 通过截图名称访问截取的屏幕

显示服务器支持

• Wayland：自动检测和使用Wayland显示服务器。
• X11：自动检测和使用X11显示服务器。

通过上述设置，您可以灵活地在不同显示环境中运行Puppeteer。