Patchright Lite MCP Server

Ein optimierter Model Context Protocol (MCP)-Server, der das Patchright Node.js SDK umschließt, um KI-Modellen Stealth-Browser-Automatisierungsfunktionen zu bieten. Dieser schlanke Server konzentriert sich auf wesentliche Funktionen, um die Nutzung einfacherer KI-Modelle zu vereinfachen.

Was ist Patchright?

Patchright ist eine unerkannte Version des Test- und Automatisierungsframeworks Playwright. Es ist als direkter Ersatz für Playwright konzipiert, verfügt jedoch über erweiterte Tarnfunktionen, um die Erkennung durch Anti-Bot-Systeme zu verhindern. Patchright unterstützt verschiedene Erkennungstechniken, darunter:

• Runtime.enable-Leck

• Console.enable-Leck

• Befehlskennzeichen-Lecks

• Allgemeine Erkennungspunkte

• Geschlossene Shadow Root-Interaktionen

Dieser MCP-Server umschließt die Node.js-Version von Patchright, um deren Funktionen KI-Modellen über ein einfaches, standardisiertes Protokoll zur Verfügung zu stellen.

Merkmale

• Einfache Benutzeroberfläche : Konzentriert sich auf die Kernfunktionalität mit nur 4 wesentlichen Tools

• Stealth-Automatisierung : Verwendet den Stealth-Modus von Patchright, um eine Erkennung zu vermeiden

• MCP-Standard : Implementiert das Model Context Protocol für eine einfache KI-Integration

• Stdio Transport : Verwendet Standard-Eingabe/Ausgabe für nahtlose Integration

Voraussetzungen

• Node.js 18+

• npm oder yarn

Installation

1. Klonen Sie dieses Repository:

   git clone https://github.com/yourusername/patchright-lite-mcp-server.git cd patchright-lite-mcp-server

2. Installieren Sie Abhängigkeiten:

   npm install

3. Erstellen Sie den TypeScript-Code:

   npm run build

Verwendung

Führen Sie den Server aus mit:

Dadurch wird der Server mit stdio-Transport gestartet und ist bereit für die Integration mit KI-Tools, die MCP unterstützen.

Integration mit KI-Modellen

Claude Desktop

Fügen Sie dies zu Ihrer Datei claude-desktop-config.json hinzu:

VS Code mit GitHub Copilot

Verwenden Sie die VS Code CLI, um den MCP-Server hinzuzufügen:

Verfügbare Tools

Der Server bietet nur 4 wesentliche Tools:

1. Durchsuchen

Startet einen Browser, navigiert zu einer URL und extrahiert Inhalte.

Widerrufsfolgen:

• Seitentitel

• Sichtbare Textvorschau

• Browser-ID (für nachfolgende Vorgänge)

• Seiten-ID (für nachfolgende Operationen)

• Screenshot-Pfad

2. Interagieren

Führt eine einfache Interaktion auf einer Seite aus.

Widerrufsfolgen:

• Aktionsergebnis

• Aktuelle URL

• Screenshot-Pfad

3. Auszug

Extrahiert bestimmten Inhalt von der aktuellen Seite.

Widerrufsfolgen:

• Extrahierter Inhalt basierend auf dem angeforderten Typ

4. Schließen

Schließt einen Browser, um Ressourcen freizugeben.

Beispiel für einen Nutzungsablauf

1. Starten Sie einen Browser und navigieren Sie zu einer Site:

   Tool: browse Parameters: { "url": "https://example.com/login", "headless": false }

2. Füllen Sie ein Anmeldeformular aus:

   Tool: interact Parameters: { "browserId": "browser-id-from-step-1", "pageId": "page-id-from-step-1", "action": "fill", "selector": "#username", "value": "user@example.com" }

3. Passwort eingeben:

   Tool: interact Parameters: { "browserId": "browser-id-from-step-1", "pageId": "page-id-from-step-1", "action": "fill", "selector": "#password", "value": "password123" }

4. Klicken Sie auf die Schaltfläche „Anmelden“:

   Tool: interact Parameters: { "browserId": "browser-id-from-step-1", "pageId": "page-id-from-step-1", "action": "click", "selector": "#login-button" }

5. Text extrahieren, um die Anmeldung zu bestätigen:

   Tool: extract Parameters: { "browserId": "browser-id-from-step-1", "pageId": "page-id-from-step-1", "type": "text" }

6. Schließen Sie den Browser:

   Tool: close Parameters: { "browserId": "browser-id-from-step-1" }

Sicherheitsüberlegungen

• Dieser Server bietet leistungsstarke Automatisierungsfunktionen. Verwenden Sie ihn verantwortungsbewusst und ethisch.

• Vermeiden Sie die Automatisierung von Aktionen, die gegen die Nutzungsbedingungen von Websites verstoßen würden.

• Beachten Sie die Ratenbegrenzungen und überlasten Sie Websites nicht mit Anfragen.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE.

Danksagung

• Patchright-nodejs von Kaliiiiiiiiii-Vinyzu

• Modellkontextprotokoll von modelcontextprotocol

Docker-Nutzung

Sie können diesen Server mit Docker ausführen:

Lokales Erstellen des Docker-Images

Erstellen Sie das Docker-Image:

Führen Sie den Container aus:

Docker Hub

Das Image wird automatisch im Docker Hub veröffentlicht, wenn Änderungen in den Hauptzweig integriert werden. Das neueste Image finden Sie unter: dylangroos/patchright-mcp