MCP-Puppeteer-Linux

Ein Model Context Protocol-Server, der Browser-Automatisierungsfunktionen mit Puppeteer bietet und Linux-Displayserver (X11 und Wayland) vollständig unterstützt. Dieser Server ermöglicht LLMs die Interaktion mit Webseiten, das Erstellen von Screenshots und die Ausführung von JavaScript in einer realen Browserumgebung.

Display-Server-Unterstützung

Dieser Fork fügt automatische Erkennung und Konfiguration für Linux-Anzeigeserver hinzu:

• Automatische X11/Wayland-Erkennung

• Dynamische Umgebungsvariablenkonfiguration

• Unterstützung für verschiedene Desktop-Umgebungen (GNOME, KDE usw.)

• Fallback-Mechanismen und robuste Fehlerbehandlung

• XWayland-Kompatibilität

Komponenten

Werkzeuge

• Puppenspieler_navigieren

  • Navigieren Sie im Browser zu einer beliebigen URL

  • Eingabe: url (Zeichenfolge)

• Puppenspieler_Screenshot

  • Machen Sie Screenshots der gesamten Seite oder bestimmter Elemente

  • Eingänge:

    • name (Zeichenfolge, erforderlich): Name für den Screenshot

    • selector (Zeichenfolge, optional): CSS-Selektor für das zu screenshottende Element

    • width (Zahl, optional, Standard: 800): Screenshot-Breite

    • height (Zahl, optional, Standard: 600): Screenshot-Höhe

• Puppenspieler_Klick

  • Klicken Sie auf Elemente auf der Seite

  • Eingabe: selector (Zeichenfolge): CSS-Selektor für anzuklickendes Element

• Puppenspieler_hover

  • Über Elemente auf der Seite schweben

  • Eingabe: selector (Zeichenfolge): CSS-Selektor für das zu schwebende Element

• Puppenspieler_Füllung

  • Eingabefelder ausfüllen

  • Eingänge:

    • selector (Zeichenfolge): CSS-Selektor für Eingabefeld

    • value (Zeichenfolge): Auszufüllender Wert

• Puppenspieler_Auswahl

  • Wählen Sie ein Element mit dem Tag SELECT aus

  • Eingänge:

    • selector (Zeichenfolge): CSS-Selektor für das auszuwählende Element

    • value (Zeichenfolge): Auszuwählender Wert

• Puppenspieler_auswerten

  • Ausführen von JavaScript in der Browserkonsole

  • Eingabe: script (Zeichenfolge): Auszuführender JavaScript-Code

Ressourcen

Der Server bietet Zugriff auf zwei Arten von Ressourcen:

1. Konsolenprotokolle ( console://logs )

   • Browserkonsolenausgabe im Textformat

   • Enthält alle Konsolenmeldungen vom Browser

2. Screenshots ( screenshot://<name> )

   • PNG-Bilder der aufgenommenen Screenshots

   • Zugriff über den bei der Aufnahme angegebenen Screenshot-Namen

Hauptmerkmale

• Browserautomatisierung mit Linux-Displayserver-Unterstützung

• Automatische X11/Wayland-Erkennung und -Konfiguration

• Konsolenprotokollüberwachung

• Screenshot-Funktionen

• JavaScript-Ausführung

• Grundlegende Webinteraktion (Navigation, Klicken, Ausfüllen von Formularen)

Konfiguration

Claude Desktop-Konfiguration

Installation

Installation über Smithery

So installieren Sie Puppeteer Linux für Claude Desktop automatisch über Smithery :

Manuelle Installation

1. Klonen Sie das Repository:

2. Installieren Sie Abhängigkeiten:

3. Starten Sie den Server:

Serverdetails anzeigen

Der Server erkennt und konfiguriert automatisch die entsprechende Anzeigeumgebung:

Wayland-Unterstützung

• Erkennt Wayland-Sitzungen über WAYLAND_DISPLAY

• Konfiguriert die erforderlichen Umgebungsvariablen:

  • WAYLAND_DISPLAY

  • QT_QPA_PLATFORM

  • GDK_BACKEND

  • MOZ_ENABLE_WAYLAND

  • XDG_SESSION_TYPE

X11-Unterstützung

• Fallback für traditionelle X11-Sitzungen

• Verarbeitet X11-spezifische Variablen:

  • DISPLAY

  • XAUTHORITY

• Unterstützt verschiedene Desktop-Umgebungen und Fenstermanager

Lizenz

Dieser MCP-Server ist unter der MIT-Lizenz lizenziert. Das bedeutet, dass Sie die Software unter den Bedingungen der MIT-Lizenz frei verwenden, ändern und verbreiten dürfen. Weitere Informationen finden Sie in der LICENSE-Datei im Projekt-Repository.