](https://mseep.ai/app/phialsbasement-mcp-puppeteer-linux)
MCP木偶Linux
](https://smithery.ai/server/@PhialsBasement/mcp-puppeteer-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代码
资源
服务器提供对两种资源的访问：
- 控制台日志 (
console://logs)
- 文本格式的浏览器控制台输出 - 包括来自浏览器的所有控制台消息
- 截图 (
screenshot://)
- 捕获的屏幕截图的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手动安装
- 克隆存储库：
git clone https://github.com/PhialsBasement/MCP-Puppeteer-Linux.git- 安装依赖项：
npm install- 启动服务器：
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文件。