Den solvethree-MCP-Server in Docker ausführen

Speichern Sie dies als Dockerfile. Es installiert das offizielle Paket unter Node 22, wechselt zum Benutzer node ohne Root-Rechte und startet solvethree-mcp als Einstiegspunkt des Containers. Die Befehle zum Erstellen und Ausführen finden Sie unten.

FROM node:22.23.4-alpine
RUN npm install --global https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz
USER node
ENTRYPOINT ["solvethree-mcp"]

# Build: docker build -t solvethree-mcp-local .
# Forward variables already set in the host; do not add their values to this file.
# Run: docker run --rm -i -e SOLVETHREE_API_KEY -e SOLVETHREE_PROXY solvethree-mcp-local

Setzen Sie vor der Ausführung in der Umgebung, die Docker startet, SOLVETHREE_API_KEY auf Ihren Workspace-API-Schlüssel und SOLVETHREE_PROXY auf Ihren Proxy. Jedes -e NAME reicht eine vorhandene Variable durch; es legt keinen Wert fest. Halten Sie Zugangsdaten aus dem Dockerfile und dem Image heraus.

Das Image wird lokal als solvethree-mcp-local erstellt; ein Docker-Hub-Konto ist nicht erforderlich. Seine Ausführung erstellt weder einen gehosteten MCP-Endpunkt noch fügt sie Browserautomatisierung hinzu.

Konfigurieren Sie einen stdio-Server in Ihrem MCP-Host. Verwenden Sie Docker als Befehl, nicht solvethree-mcp: Der Einstiegspunkt des Images startet die ausführbare Datei im Container.

Fügen Sie -t nicht hinzu. Der Host benötigt stdin und stdout des Containers für JSON-RPC. --rm entfernt den Container, wenn er beendet wird.

Beide Umgebungsvariablen müssen für den MCP-Hostprozess verfügbar sein. Sie in einem Terminal zu setzen, hilft einem anderweitig gestarteten Host nur, wenn er sie erbt. Falls der Host die Weitergabe von Umgebungsvariablen einschränkt, geben Sie beide Namen frei.

Verwenden Sie für eine TOML-Konfiguration im Codex-Stil die Tabelle mcp_servers.solvethree mit dem oben angegebenen Befehl und den Argumenten. Nehmen Sie beide Variablennamen in env_vars auf, setzen Sie startup_timeout_sec auf 60 und tool_timeout_sec auf 100. Den zugrunde liegenden Serververtrag finden Sie in der Dokumentation zur MCP-Integration.

1. 1.

   Die verfügbaren Tools prüfen

   Rufen Sie nach dem Verbinden solvethree_capabilities auf. Der Server stellt Tools zum Lösen und zum Abrufen von Aufgaben bereit; er steuert keinen Browser und füllt keine Formulare aus.

2. 2.

   Das reCAPTCHA-Profil vorbereiten

   Richten Sie für reCAPTCHA unter Website-Profile ein aktives Profil ein, bevor Sie eine Lösung anfordern. Stimmen Sie Hostnamen, Erfassungsaktion und reCAPTCHA-Typ ab; gehen Sie nicht davon aus, dass ein Domainprofil jede Aktion abdeckt. Das Senden einer Aufgabe erstellt kein Profil. Die Anleitung zur Profileinrichtung erläutert diese Voraussetzung.

3. 3.

   Eine logische Aufgabe erstellen

   Rufen Sie solvethree_create_recaptcha mit site, action und einer requestId auf; recaptchaType und waitMs sind optional. Dieses Tool liest seinen einzigen Proxy aus SOLVETHREE_PROXY. Jeder Erstellungsaufruf erzeugt höchstens eine Aufgabe. Kommt es bei der Erstellung zu einer Zeitüberschreitung, verwenden Sie dieselbe Anfrage-ID mit unveränderten Eingaben erneut, um die vorhandene Aufgabe wiederherzustellen, statt eine weitere zu erstellen.

4. 4.

   Auf ein verwendbares Ergebnis warten

   Hat die Aufgabe den Status pending oder solving, rufen Sie sie mit solvethree_get_task ab. Nur ready enthält eine verwendbare Lösung. Beenden Sie bei failed die Abfragen und prüfen Sie errorCode und error, bevor Sie entscheiden, was geändert werden soll.

5. 5.

   Aus Ihrer Anwendung senden

   Senden Sie für reCAPTCHA solution.token, nicht die Aufgaben-ID. Verwenden Sie die zurückgegebene Identität aus userAgent und secChUa mit dem erfolgreichen Proxy. Eine fertige Aufgabe bedeutet, dass eine Lösung erzeugt wurde, nicht, dass das Ziel die Anfrage Ihrer Anwendung akzeptiert hat.

Der MCP-Host erhält private Lösungsdaten. Halten Sie diese Ergebnisse aus gemeinsam genutzten Protokollen heraus; Ihre Anwendung bleibt dafür verantwortlich, sie an das vorgesehene Ziel zu senden.