auth-fetch-mcp

MCP-Server, der es KI-Assistenten ermöglicht, Inhalte von authentifizierten Webseiten abzurufen.

Wenn Ihre KI versucht, eine URL zu lesen, die eine Anmeldung erfordert, öffnet dieses Tool einen echten Browser, damit Sie sich anmelden können – anschließend wird der Seiteninhalt als bereinigtes HTML erfasst. Sitzungen werden lokal gespeichert, sodass Sie sich nur einmal pro Dienst anmelden müssen.

Demo

Related MCP server: byob

Schnellstart

Claude Code

claude mcp add --scope user auth-fetch -- npx auth-fetch-mcp@latest

.mcp.json (Cursor, Windsurf, etc.)

{
  "mcpServers": {
    "auth-fetch": {
      "command": "npx",
      "args": ["auth-fetch-mcp@latest"]
    }
  }
}

Chromium wird beim ersten Start automatisch installiert, falls es noch nicht vorhanden ist.

Funktionsweise

1. Bitten Sie Ihre KI, eine beliebige authentifizierte Seite zu lesen – fügen Sie einfach die URL ein.

2. Ein Browserfenster öffnet sich automatisch und navigiert zur Seite.

3. Melden Sie sich wie gewohnt an (unterstützt SSO, 2FA, CAPTCHA – alles).

4. Klicken Sie auf die Schaltfläche "📸 Capture" in der unteren rechten Ecke, wenn Sie bereit sind.

5. Der Seiteninhalt wird als bereinigtes HTML erfasst (Störelemente entfernt, Medien-Tags beibehalten), der Browser schließt sich und Ihre KI erhält den Inhalt.

Tools

auth_fetch

Das primäre Tool. Ruft Seiteninhalte über einen echten Browser ab und öffnet bei Bedarf ein Fenster für die Anmeldung. Gibt bereinigtes HTML zurück, bei dem Störelemente (Navigation, Fußzeile, Skripte usw.) entfernt und Medien-Tags (<img>, <video>, <iframe>) beibehalten wurden.

download_media

Lädt Dateien von URLs unter Verwendung gespeicherter Browsersitzungen herunter. Verwenden Sie dies, um Bilder, Videos oder andere Dateien, die in auth_fetch-Ergebnissen gefunden wurden, nachträglich herunterzuladen. Die gespeicherten Cookies des Browsers handhaben die Authentifizierung automatisch – eine erneute Anmeldung ist nicht erforderlich.

Beispielablauf:

1. auth_fetch("https://notion.so/my-page")
   → Returns HTML with <img src="https://s3.notion.so/signed-url..."/> tags

2. AI reads the HTML, identifies an image it needs

3. download_media(["https://s3.notion.so/signed-url..."])
   → Downloads the image using saved session cookies
   → Returns { localPath: "~/.auth-fetch-mcp/downloads/.../file-1.png" }

list_pages

Listet alle offenen Tabs im Browser mit ihren URLs und Titeln auf.

close_browser

Schließt das Browserfenster. Anmeldesitzungen werden gespeichert und beim nächsten Mal wiederverwendet.

Datenspeicherung

Alle Daten werden lokal unter ~/.auth-fetch-mcp/ gespeichert. Es werden keine Daten an externe Server gesendet.

So löschen Sie alle Daten:

# Clear login sessions only
rm -rf ~/.auth-fetch-mcp/browser-data/

# Clear downloaded files only
rm -rf ~/.auth-fetch-mcp/downloads/

# Clear everything
rm -rf ~/.auth-fetch-mcp/

Unterstützte KI-Tools

• Claude Code

• Cursor

• Windsurf

• Jeder MCP-kompatible Client, der stdio-Transport verwendet

Einschränkungen

• Erfordert eine lokale Umgebung (funktioniert nicht in webbasierten Chat-Oberflächen)

• Der erste Zugriff auf jeden Dienst erfordert eine manuelle Anmeldung

• Sehr lange Seiten werden gekürzt, um in die LLM-Kontextfenster zu passen (100.000 Zeichen)

• Einige Websites mit aggressiver Bot-Erkennung funktionieren möglicherweise nicht (versuchen Sie die Option wait_for)

Datenschutz

• Alle Daten verbleiben auf Ihrem Computer – nichts wird an externe Server gesendet

• Erfasstes HTML wird niemals auf die Festplatte geschrieben – es durchläuft nur die stdio-Pipe zum KI-Tool

• Browsersitzungen werden lokal als Standard-Chromium-Profil gespeichert

• Heruntergeladene Dateien landen in einem lokalen Verzeichnis, das Sie kontrollieren

Mitwirken

Beiträge sind willkommen! Bitte öffnen Sie ein Issue oder senden Sie einen Pull Request.

git clone https://github.com/ymw0407/auth-fetch-mcp.git
cd auth-fetch-mcp
npm install
npm run build

Lizenz

MIT