Summary
The Puppeteer server, minus the Linux display fight.
The automation surface is the standard one; the reason to pick this fork is that it starts on GNOME, KDE and Wayland instead of failing on a display variable it could not find.
What it is
A fork of the Puppeteer MCP server that adds Linux display-server handling: X11 and Wayland detected automatically, environment variables set dynamically, XWayland compatibility, and fallbacks when detection fails. The browser surface itself is navigation, screenshots, clicking, hovering, filling, selecting and JavaScript evaluation.
What you get
- A real browser navigated to any URL
- Screenshots of the whole page or one element, at a width and height you set
- Elements clicked and hovered, and select boxes set to a value
- Input fields filled
- JavaScript executed in the browser console
- Browser console output available as a resource
- Captured screenshots available as resources by name
- X11 and Wayland detected and configured automatically, including XWayland
Requirements
A Linux desktop running X11 or Wayland, and Node.js. The browser runs on your machine under your account, so it reaches whatever you can reach.
Setup effort
One command — npx -y @smithery/cli install @PhialsBasement/mcp-puppeteer-linux --client claude