MCP Puppeteer Linux Server

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:

Konsolenprotokolle ( console://logs )
- Browserkonsolenausgabe im Textformat
- Enthält alle Konsolenmeldungen vom Browser
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

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

Installation

Installation über Smithery

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

npx -y @smithery/cli install @PhialsBasement/mcp-puppeteer-linux --client claude

Manuelle Installation

Klonen Sie das Repository:

git clone https://github.com/PhialsBasement/MCP-Puppeteer-Linux.git

Installieren Sie Abhängigkeiten:

npm install

Starten Sie den Server:

ts-node index.ts

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.

MCP Puppeteer Linux Server

Integrations