Fredy MCP Bridge

Ein Sidecar-Container für Fredy, der Fredys MCP-Server um fehlende Funktionen ergänzt – ohne Fredy selbst zu verändern. Fredy bleibt ein ganz normales Image und kann wie gewohnt aktualisiert werden.

Inoffizielle Ergänzung, nicht Teil des Fredy-Projekts. Alle Anerkennung für Fredy gebührt Christian Kellner und den Fredy-Mitwirkenden. Details siehe LICENSE.txt.

Was die Bridge macht

MCP-Client (Claude.ai, ChatGPT, …)
        │  https://fredy-mcp.example.de/mcp   (OAuth)
        ▼
 Fredy MCP Bridge ──► Fredys eigener MCP-Server  /api/mcp      (alle Fredy-Tools, 1:1 durchgereicht)
                  └─► Fredys REST-API             /api/listings… (Zusatz-Tools, als der jeweilige Benutzer)

• Durchreichen: Alle Tools von Fredys MCP erscheinen unverändert – auch solche, die Fredy künftig neu mitbringt.

• Ergänzen: Inserate löschen (ausblenden) und wiederherstellen, endgültig löschen, Bewerbungsstatus, Betrugsmarkierung, Suchjob starten, Suchjob aktivieren/pausieren.

• OAuth für Remote-Connectoren mit eigener Login-Seite – angemeldet wird mit dem Fredy-Konto.

• Rechte pro Verbindung: Was Fredy anbietet, ist standardmäßig an; alle Zusätze sind Opt-in. Einzelne Fredy-Tools lassen sich pro Verbindung sperren. Verbindungen jederzeit trennbar.

• Rollen-Obergrenzen: Admins legen fest, was Fredy-Admins bzw. normale Benutzer überhaupt freigeben dürfen.

• Sprachen wie Fredy: Englisch (Standard), Deutsch, Spanisch, Französisch, Italienisch. Nach dem Login folgt die Oberfläche der Sprache im Fredy-Profil; Änderungen dort greifen innerhalb einer Minute. Ohne gewählte Sprache – oder bei einer Sprache, die die Bridge nicht kennt – Englisch.

• Fredy entscheidet über Sichtbarkeit: Jeder Aufruf läuft über Fredys Reverse-Proxy-Anmeldung als genau der verbundene Benutzer. Eigene/geteilte Jobs, Admin-Rechte und Demo-Modus prüft Fredy selbst.

Löschen vs. endgültig löschen

Related MCP server: Universal MCP Gateway

Einrichtung

1. Stack in Portainer erweitern

Siehe docker-compose.example.yml. Wichtig sind das gemeinsame Netz fredy-net mit fester IP für die Bridge und die Stack-Variable FREDY_PROXY_SECRET (z. B. openssl rand -hex 32).

2. Fredy: Reverse-Proxy-Anmeldung

Fredy → Einstellungen → System → Anmeldung durch den Reverse-Proxy:

• Identitäts-Header von vertrauenswürdigen Proxys akzeptieren: an

• Vertrauenswürdige Proxy-Adressen: 172.31.250.10 (nur die Bridge, kein ganzes Netz)

• Benutzername-Header: Remote-User

• Header für gemeinsames Geheimnis: X-Fredy-Proxy-Secret

• Gemeinsames Geheimnis: derselbe Wert wie FREDY_PROXY_SECRET

Fredy prüft die TCP-Gegenstelle, nicht X-Forwarded-For. Zugriffe aus dem Internet oder dem LAN kommen nie von 172.31.250.10 – und brauchen zusätzlich das Geheimnis. Der normale Fredy-Login funktioniert unverändert weiter.

3. Reverse Proxy (z. B. Nginx Proxy Manager)

Proxy Host für die Subdomain der Bridge → http://<Docker-Host-IP>:9999, SSL-Zertifikat (Let's Encrypt), Force SSL. Claude.ai verlangt HTTPS.

4. Erste Anmeldung

https://<bridge>/ öffnen und einmal als Fredy-Admin anmelden. Unter Zustand sollten alle drei Prüfungen grün sein. Danach im MCP-Client die Connector-URL https://<bridge>/mcp eintragen.

Betrieb

• Daten: /data/bridge.sqlite (Verbindungen, Rechte, Tokens als Hash). Fredys Datenbank wird nie angefasst.

• Selbsttest: beim Start, stündlich und auf der Admin-Übersicht. Ändert Fredy seine interne REST-API, steht das deutlich im Log (!!! Selbsttest …) und unter Zustand.

• Wenn Fredy die Zusätze selbst mitbringt: Ein gleichnamiges Fredy-Tool ersetzt automatisch das Bridge-Tool.

• Tokens: Access-Token 1 h, Refresh-Token 30 Tage (rotierend; ein wiederverwendeter alter Refresh-Token widerruft die Token-Familie).

Entwicklung

npm install
npm test
PUBLIC_URL=http://localhost:3000 FREDY_URL=http://127.0.0.1:9998 FREDY_PROXY_SECRET=… DATA_DIR=./data npm start
npm run licenses   # LICENSE.txt nach Paket-Updates neu erzeugen

Übersetzungen liegen in src/locales/<sprache>.json; en.json ist die Referenz. Der Test test/i18n.test.js prüft, dass jede Sprache alle Schlüssel und dieselben Platzhalter hat.