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
Installation
- Klonen Sie dieses Repository:
git clone https://github.com/yourusername/patchright-lite-mcp-server.git
cd patchright-lite-mcp-server
- Installieren Sie Abhängigkeiten:
- Erstellen Sie den TypeScript-Code:
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:
{
"mcpServers": {
"patchright": {
"command": "node",
"args": ["path/to/patchright-lite-mcp-server/dist/index.js"]
}
}
}
VS Code mit GitHub Copilot
Verwenden Sie die VS Code CLI, um den MCP-Server hinzuzufügen:
code --add-mcp '{"name":"patchright","command":"node","args":["path/to/patchright-lite-mcp-server/dist/index.js"]}'
Der Server bietet nur 4 wesentliche Tools:
1. Durchsuchen
Startet einen Browser, navigiert zu einer URL und extrahiert Inhalte.
Tool: browse
Parameters: {
"url": "https://example.com",
"headless": true,
"waitFor": 1000
}
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.
Tool: interact
Parameters: {
"browserId": "browser-id-from-browse",
"pageId": "page-id-from-browse",
"action": "click", // can be "click", "fill", or "select"
"selector": "#submit-button",
"value": "Hello World" // only needed for fill and select
}
Widerrufsfolgen:
- Aktionsergebnis
- Aktuelle URL
- Screenshot-Pfad
3. Auszug
Extrahiert bestimmten Inhalt von der aktuellen Seite.
Tool: extract
Parameters: {
"browserId": "browser-id-from-browse",
"pageId": "page-id-from-browse",
"type": "text" // can be "text", "html", or "screenshot"
}
Widerrufsfolgen:
- Extrahierter Inhalt basierend auf dem angeforderten Typ
4. Schließen
Schließt einen Browser, um Ressourcen freizugeben.
Tool: close
Parameters: {
"browserId": "browser-id-from-browse"
}
Beispiel für einen Nutzungsablauf
- Starten Sie einen Browser und navigieren Sie zu einer Site:
Tool: browse
Parameters: {
"url": "https://example.com/login",
"headless": false
}
- 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"
}
- Passwort eingeben:
Tool: interact
Parameters: {
"browserId": "browser-id-from-step-1",
"pageId": "page-id-from-step-1",
"action": "fill",
"selector": "#password",
"value": "password123"
}
- 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"
}
- 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"
}
- 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:
docker run -it --rm dylangroos/patchright-mcp
Lokales Erstellen des Docker-Images
Erstellen Sie das Docker-Image:
docker build -t patchright-mcp .
Führen Sie den Container aus:
docker run -it --rm patchright-mcp
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