ai-tools/private-proxy-mcp
Watch
2
0
Fork
You've already forked private-proxy-mcp
 0
Code Issues 2 Pull requests 1 Projects Releases 5 Packages 2 Wiki Activity Actions
Page: ADR-Browser-Backend
Pages
ADR-Browser-Backend ADR-Browser-Identity-Playwright ADR-MCP-Go-SDK ADR-Rust-Proxy-Tauri ADR-Tunnel-Protocol Architecture CLI Compatibility Configuration Deployment Desktop-Proxy Development Home MVP-Acceptance Releases Security-MCP-Exposure Security-Network-Policy Shared-Key Troubleshooting
1 ADR-Browser-Backend
Forgeagent edited this page 2026-07-20 10:25:02 +02:00
Table of contents

ADR: Browser-Backend (chromedp)

Kontext

Browser-Sessions müssen auf dem Private-Proxy-Host laufen, isoliert bleiben und die bestehende Ziel-Policy auf jede Netzwerkanfrage anwenden. Die MCP-Oberfläche soll klein und ohne Debug-Port bleiben und in das Single-Binary-Deployment passen.

Entscheidung

  • Backend: github.com/chromedp/chromedp hinter browserexec.Executor.
  • Chromium ist ein explizit konfiguriertes, versiongeprüftes Laufzeit-Artefakt.
  • Jede browser_open-Session ist ein neues Off-the-Record-BrowserContext mit einem Tab; keine Profil-/Cookie-/Storage-Wiederverwendung.
  • CDP nur über privaten Pipe/stdio, nie als Netz-Listener.
  • Navigation, Redirects und HTTP(S)-Subresources laufen über dieselbe httpexec.NetworkPolicy plus Loopback-Egress-Proxy gegen DNS-Rebinding.
  • Downloads sind verboten; Snapshots/Screenshots sind bytebegrenzt und bleiben als kurzlebige Artifact-/Resource-Links auf dem privaten Host.
  • MCP akzeptiert kein caller-supplied JavaScript.

Folgen

  • MVP unterstützt nur Chromium.
  • Operatoren müssen die dokumentierte Chromium-Version pflegen.
  • Playwright als wählbares Backend ist in ADR-Browser-Identity-Playwright spezifiziert.