Auto Browser

Geben Sie Ihrem KI-Agenten einen echten Browser, mit einem Menschen in der Schleife.

Auto Browser ist eine MCP-native Browser-Steuerungsebene für autorisierte Workflows. Sie bietet MCP-Clients, LLM-Agenten und Operatoren einen gemeinsam genutzten Playwright-Browser mit menschlicher Übernahme, wiederverwendbaren Authentifizierungsprofilen, Genehmigungen, Audit-Protokollen und Local-First-Bereitstellung.

Funktioniert mit:

• Claude Desktop

• Cursor

• jedem MCP-Client, der HTTP oder stdio unterstützt

• direkten REST-Aufrufen, wenn Sie eine curl-first-Steuerung bevorzugen

Warum Auto Browser

• Von Anfang an MCP-nativ. Die Browser-Oberfläche ist bereits als MCP-Server verpackt, anstatt nachträglich hinzugefügt zu werden.

• Menschliche Übernahme, wenn das Web spröde wird. noVNC hält dieselbe Live-Sitzung verfügbar, wenn eine Person eingreifen muss.

• Einmal einloggen, später wiederverwenden. Speichern Sie benannte Authentifizierungsprofile und öffnen Sie neue Sitzungen, die bereits angemeldet sind.

• Standardmäßig Local-First. Führen Sie den gesamten Stack auf Ihrem eigenen Rechner mit Docker Compose aus oder nutzen Sie Codespaces für eine schnelle gehostete Demo.

• Integrierte Sicherheitsvorkehrungen. Genehmigungen, Identität des Operators, PII-Bereinigung, Witness-Belege und Compliance-Vorlagen sind Teil der Produktoberfläche.

Related MCP server: Browser-Use MCP Server

Release-Highlights (v1.0.2)

• Framework-Sicherheitsupdates mit FastAPI und Starlette, die auf die aktuelle gepatchte Linie festgelegt sind

• Sicherere Fehlergrenzen über Browser-Aktionen, CDP, OCR, Mesh, Workflow, Tunnel, Social und Share-Token-Oberflächen

• Ratenbegrenzungs-Härtung mit begrenzten Buckets und gehashten Operator-Identifikatoren

• Verschärfung der Host- und Pfadrichtlinien für produktive ALLOWED_HOSTS, Authentifizierungsprofilpfade und Upload-Roots

• 1.0 Plattform-Oberfläche einschließlich signierter Mesh-Delegierung, Workflow-Routen, /dashboard, noVNC-Übernahme, MCP-Transport, Audit-Protokollen und Bereitschaftsprüfungen

Siehe CHANGELOG.md für die vollständige Release-Historie.

Gute Einsatzmöglichkeiten

• interne Dashboards und Admin-Tools

• operator-unterstützte Qualitätssicherung und Browser-Debugging

• Einmal-Login, später wiederverwenden von Account-Workflows

• spröde Websites, bei denen ein Mensch den Ablauf wiederherstellen muss

• MCP-gestützte Agenten-Workflows, die einen echten Browser benötigen, nicht nur HTML-Abrufe

Nicht das Ziel

• Stealth- oder Anti-Bot-Arbeit

• CAPTCHA-Lösung

• unbefugtes Scraping oder Account-Automatisierung

• täuschende Identitätsgestaltung oder Umgehungstools

Was Sie bekommen

Schnellstart

git clone https://github.com/LvcidPsyche/auto-browser.git
cd auto-browser
docker compose up --build

Das reicht für die lokale Entwicklung mit den Standardeinstellungen.

Optional:

cp .env.example .env
make doctor

Führen Sie make doctor von einem normalen Terminal mit lokalem Docker-Zugriff und Berechtigung zum Öffnen von Localhost-Sockets aus.

Öffnen:

• API-Dokumentation: http://127.0.0.1:8000/docs

• Operator-Dashboard: http://127.0.0.1:8000/dashboard

• Visuelle Übernahme: http://127.0.0.1:6080/vnc.html?autoconnect=true&resize=scale

Alle veröffentlichten Ports binden standardmäßig an 127.0.0.1.

In Codespaces ausprobieren

Codespaces stellt den Stack automatisch bereit. Das Dashboard und die noVNC-Tabs sind normalerweise in etwa 90 Sekunden bereit.

Erste nützliche Demo

Der Ablauf mit der höchsten Signalwirkung in diesem Repo ist:

1. eine Sitzung erstellen

2. manuell einloggen, falls die Website einen Menschen benötigt

3. die Sitzung als benanntes Authentifizierungsprofil speichern

4. eine neue Sitzung aus diesem Authentifizierungsprofil öffnen

5. Arbeit fortsetzen, ohne sich erneut authentifizieren zu müssen

Starten Sie hier:

• examples/login-and-save-profile.md

• examples/README.md

Minimale Sitzungserstellung:

curl -s http://127.0.0.1:8000/sessions \
  -X POST \
  -H 'content-type: application/json' \
  -d '{"name":"demo","start_url":"https://example.com"}' | jq

Minimale Beobachtung:

curl -s http://127.0.0.1:8000/sessions/<session-id>/observe | jq

MCP-Clients

Auto Browser bietet:

• einen HTTP-MCP-Endpunkt unter http://127.0.0.1:8000/mcp

• Komfort-Endpunkte unter http://127.0.0.1:8000/mcp/tools und http://127.0.0.1:8000/mcp/tools/call

• eine gebündelte stdio-Brücke unter scripts/mcp_stdio_bridge.py

Das Standard-MCP-Toolprofil ist curated, was die Browser-Oberfläche kompakt hält, um eine bessere Tool-Auswahl zu ermöglichen. Wenn Sie die vollständige interne Tool-Oberfläche wünschen, setzen Sie:

MCP_TOOL_PROFILE=full

Beispiel für einen rohen Tool-Aufruf:

curl -s http://127.0.0.1:8000/mcp/tools/call \
  -X POST \
  -H 'content-type: application/json' \
  -d '{
    "name":"browser.create_session",
    "arguments":{
      "name":"demo",
      "start_url":"https://example.com"
    }
  }' | jq

Anleitungen zur Client-Einrichtung:

• docs/mcp-clients.md

• examples/claude-desktop-setup.md

• examples/cursor-mcp-setup.md

• examples/claude_desktop_config.json

Sicherheit und Compliance

Für eine echte private Bereitstellung setzen Sie mindestens:

APP_ENV=production
API_BEARER_TOKEN=<strong-random-secret>
REQUIRE_OPERATOR_ID=true
AUTH_STATE_ENCRYPTION_KEY=<44-char-fernet-key>
REQUIRE_AUTH_STATE_ENCRYPTION=true
REQUEST_RATE_LIMIT_ENABLED=true
METRICS_ENABLED=true

COMPLIANCE_TEMPLATE kann beim Start eine vorkonfigurierte Haltung anwenden:

Alle Vorlagen erfordern Upload-Genehmigungen. HIPAA, SOC2 und PCI-DSS aktivieren zusätzlich Witness-Belege. Beim Start wird die angewendete Richtlinie in /data/compliance-manifest.json geschrieben.

Beispiel:

COMPLIANCE_TEMPLATE=HIPAA docker compose up

Details zur Bereitstellung, gehostete Witness-Hinweise, CLI-Auth-Modi und Anleitungen für Reverse-SSH finden Sie unter:

• docs/deployment.md

• docs/production-hardening.md

Architektur auf einen Blick

flowchart LR
    User[Human operator] -->|watch / takeover| noVNC[noVNC]
    LLM[OpenAI / Claude / Gemini] -->|shared tools| Controller[Controller API]
    Controller -->|Playwright protocol| Browser[Browser node]
    noVNC --> Browser
    Browser --> Artifacts[(screenshots / traces / auth state)]
    Controller --> Artifacts
    Controller --> Policy[Allowlist + approval gates]

Kernkomponenten:

• browser-node/ führt Chromium, Xvfb, x11vnc und noVNC aus

• controller/ stellt den FastAPI-Controller, MCP-Transport, Richtlinien-Schienen und Orchestrierungs-Endpunkte bereit

• data/ enthält Laufzeit-Artefakte, Auth-Status, Genehmigungen, Audit-Protokolle und optionale CLI-Caches

• scripts/ enthält lokale Helfer für Doctor, Smoke-Tests, Brücken und Release-Prüfungen

Repo-Leitfaden

Häufige Befehle

Dokumentationskarte

Mitwirken

Wenn Sie helfen möchten, beginnen Sie mit:

• CONTRIBUTING.md

• docs/good-first-issues.md

• CODE_OF_CONDUCT.md

Wenn Auto Browser nützlich ist, hilft ein Stern anderen dabei, es zu finden.