FYOS-Hub

Der Hub von FYOS (For Your Own Sake): ein MCP-Server, der viele Plugins unter einer Adresse anbietet. Ein Plugin liefert Werkzeuge und, wenn es will, eine Oberfläche (ui://-HTML). Die Shell zeigt diese Oberflächen als Fenster, jeder MCP-Client mit MCP-Apps-Unterstützung im Gespräch.

Der Hub spricht dreierlei:

• MCP unter /mcp (Streamable HTTP) für Agenten und Chat-Clients,
• REST unter /hub/* für die Shell und Skripte,
• Gesundheit unter /health.

Die genauen Wege und Formate stehen in docs/HUB-VERTRAG.md.

Installieren und starten

pip install ".[suche]"          # Kern; [suche] bringt Qdrant-Client und numpy (optional)
fyos-hub                        # oder: python3 -m mcp_hub.server

Als Bild: docker build -t fyos-hub hub/ (Build-Argument EXTRA_PIP installiert weitere Plugin-Pakete, z. B. --build-arg EXTRA_PIP="fyos-plugin-finanzen"). Das Bild lauscht auf Port 8080.

Das Bild installiert Plugin-Pakete mit uv statt mit pip. Liegen sie in einem eigenen Paketindex, kommt dessen Adresse als --build-arg FYOS_INDEX_URL=<Index-URL> und steht damit vor PyPI. --index-strategy first-index steht ausdrücklich im Befehl: uv nimmt ein Paket nur aus dem ersten Index, der es führt, ein Paket gleichen Namens auf PyPI kann das eigene also nicht verdrängen (Dependency Confusion; mit pip --extra-index-url wäre das möglich). Die Version von uv ist im Dockerfile fest.

Ohne Konfigurationsdatei lädt der Hub jedes installierte Plugin der Entry-Point-Gruppe mcp_hub.plugins mit seinen Vorgaben. Eine Datei (MCP_HUB_CONFIG_PATH, Vorgabe ./config.yaml) braucht es nur für Plugin-Einstellungen, Geheimnisse oder enabled: false; siehe config.example.yaml.

Mitgelieferte Plugins

Alles Weitere (Finanzen, Haus, Betrieb …) sind eigene Pakete, die sich per Entry-Point melden.

Ein eigenes Plugin

# pyproject.toml des Plugin-Pakets
[project.entry-points."mcp_hub.plugins"]
meins = "mein_paket.plugin:MeinPlugin"

uv pip install ./mein-plugin    # danach lädt der Hub es ohne Eintrag in config.yaml

Die Klasse erbt von mcp_hub.plugin.HubPlugin (register, describe_tools, call, optional health, describe_resources). Hat das Plugin eine Oberfläche, liegen die HTML-Dateien in <paket>/ui/; das Plugin übergibt den Paketnamen an mcp_hub.plugins._oberflaeche.oberflaeche(datei, "mein_paket"), und _identitaet.registriere_app(...) gibt der App Titel, Symbol und Farbton. plugins/beispiel_app.py zeigt alles in 200 Zeilen.

Umgebungsvariablen

Die OS-Brücke braucht für mehrere Replikate Redis; ein einzelner Hub funktioniert nur mit REDIS_URL.

Takte begrenzen

Wiederkehrende Aufgaben eines Plugins erscheinen in mcp.zeitplan und /metrics. Fährt das Plugin sie über den Wächter mcp_hub.takt, können sie zwei Grenzen haben: max_pro_tag (Läufe je Tag) und fenster (Uhrzeiten wie "07:00-22:00", auch über Mitternacht). Außerhalb des Fensters oder über dem Limit läuft die Aufgabe nicht; der Hub zählt die übersprungenen Läufe (fyos_zeitplan_uebersprungen_total{takt, grund}, dazu fyos_zeitplan_laeufe_heute{takt}) und führt je Takt ein knappes Laufprotokoll (Start, Dauer, Ergebnis; die letzten 20 Läufe) im Hub-Speicher. Tag und Uhrzeit gelten in der Zeitzone des Hubs (TZ). Ohne Grenzen läuft alles wie vorher. Die Takte des mitgelieferten Plugins openclaw stellt takt_grenzen in seiner config ein (config.example.yaml); eigene Plugins binden den Wächter nach docs/ERWEITERN.md §2.12 ein.

Anmeldung (optional)

Innen, im eigenen Netz, ist der Hub offen. Soll er auch aus dem Internet erreichbar sein, genügt ein OpenID-Connect-Anbieter: FYOS_OIDC_ISSUER und FYOS_OIDC_CLIENTS (Client-IDs, mit Komma) setzen, der Reverse-Proxy setzt auf Anfragen aus dem Internet den Kopf X-FYOS-Zugang: extern. Dann verlangt /mcp für diese Anfragen ein gültiges Token (RFC 9728, Discovery der Schlüssel, nur RS256/ES256/EdDSA). Weitere Schalter: FYOS_OIDC_MODUS (aus, an, streng), FYOS_OIDC_HOSTS, FYOS_OIDC_REST, FYOS_OIDC_BENUTZER, FYOS_OIDC_SCOPES, FYOS_OIDC_JWKS_URL. Ohne FYOS_OIDC_ISSUER antworten Anfragen von außen mit 403.

Bewusst nicht enthalten

Aus dem Ursprung dieses Hubs sind nur die allgemeinen Teile übernommen. Nicht enthalten sind die Plugins wissen und gedaechtnis, die Entwicklungsansicht (entwicklung, lage), das Chat-Tor (chat_gateway: der Hub ist selbst ein OIDC-geschützter Ressourcenserver) und alles, was zu einer einzelnen Installation gehört. Solche Plugins gehören in eigene Pakete.

Tests

pip install -e ".[suche,test]"
python3 -m pytest hub/tests -q