What it does
Librus Synergia school gradebook: grades, attendance, timetable, homework, messages.
- Connects Läuft auf deinem Computer
- Account or key Needs LIBRUS_USERNAME, LIBRUS_PASSWORD
- Category Spiele, Sport, Essen & Lernen
Warum es hier steht
Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert
| Beliebtheit | 23/80 | GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20 |
|---|---|---|
| Aktualität | 12/12 | Volle Punkte für Release oder Codeänderung in 30 Tagen |
| Antwortet noch | 0/8 | Der Cloud-Endpoint antwortete bei der letzten Prüfung |
| Nutzungswert | 35/100 |
Qualität: 3/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)
Installation
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
Mit einem Satz von deiner KI installieren lassen
Installiere bitte Librus Synergia. Folge https://mcp.popnx.com/i/krzysztofbury-librus-mcp.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen
3/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 17. Nov. 2026
Zuerst: Welche KI nutzt du?
Wähle deine App, dann erscheinen die Schritte unten.
Klappt mit Claude, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Librus Synergia (auf der Seite des Anbieters erstellen) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
Installationsdatei des Anbieters herunterladen
Die .mcpb-Datei des Entwicklers herunterladen
Die .mcpb-Datei kommt direkt vom Anbieter; wir ändern sie nicht
Datei doppelklicken, dann in der Claude-Desktop-App Install klicken
Ausprobieren
Nutze Librus Synergia und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude sagt, dass es Librus Synergia nutzt, oder ein Werkzeug von Librus Synergia in der Antwort zeigt, bist du verbunden
1 optionale Einstellung(en) (geht auch ohne)
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
LIBRUS_ALIASKurzname für diesen Login in Tool-Aufrufen.· Standard librusEnglisches Original anzeigen
Short name for this login in tool calls.
Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
ChatGPT kann Librus Synergia noch nicht verbinden
Librus Synergia läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen
Das kannst du stattdessen tun
A · Eine App nutzen, die Librus Synergia verbinden kann
- Du brauchst einen Schlüssel von Librus Synergia (auf der Seite des Anbieters erstellen) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
- Du brauchst einen Schlüssel von Librus Synergia (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
- Du brauchst einen Schlüssel von Librus Synergia (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
- Du brauchst einen Schlüssel von Librus Synergia (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
B · Andere in Spiele, Sport, Essen & Lernen, die mit ChatGPT funktionieren
Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden
- ShipSwift✓ ChatGPT
- Anime Garden✓ ChatGPT
- Summer Engine✓ ChatGPT
Klappt mit Claude Code, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Librus Synergia (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
Von der KI installieren lassen
Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Librus Synergia für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): claude mcp add --scope user librus --env LIBRUS_USERNAME=your-value --env LIBRUS_PASSWORD=your-value -- uvx librus-mcp 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei LIBRUS_USERNAME, LIBRUS_PASSWORD "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Librus Synergia wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
uv installieren (falls noch nicht vorhanden)
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
uv --version- Eine Versionsnummer wie uv … = installiert, diesen Schritt überspringen
- "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
So öffnest du das Terminal
Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst
Download-Seite von uv öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen:
uv --versionEinmal installieren, gilt für alles, was uv braucht
Bei Librus Synergia registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Terminal öffnen
Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen
Diesen Befehl einfügen und Enter drücken
claude mcp add --scope user librus --env LIBRUS_USERNAME=your-value --env LIBRUS_PASSWORD=your-value -- uvx librus-mcpErsetze „your-value“ vor dem Enter durch deinen Schlüssel
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
/mcp in Claude Code eingeben
Librus Synergia sollte in der Liste als verbunden erscheinen
Ausprobieren
Nutze Librus Synergia und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude Code sagt, dass es Librus Synergia nutzt, oder ein Werkzeug von Librus Synergia in der Antwort zeigt, bist du verbunden
1 optionale Einstellung(en) (geht auch ohne)
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
LIBRUS_ALIASKurzname für diesen Login in Tool-Aufrufen.· Standard librusEnglisches Original anzeigen
Short name for this login in tool calls.
Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit Cursor, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Librus Synergia (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
Von der KI installieren lassen
Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Librus Synergia für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "librus": { "command": "uvx", "args": [ "librus-mcp" ], "env": { "LIBRUS_USERNAME": "your-value", "LIBRUS_PASSWORD": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei LIBRUS_USERNAME, LIBRUS_PASSWORD "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Librus Synergia wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
uv installieren (falls noch nicht vorhanden)
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
uv --version- Eine Versionsnummer wie uv … = installiert, diesen Schritt überspringen
- "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
So öffnest du das Terminal
Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst
Download-Seite von uv öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen:
uv --versionEinmal installieren, gilt für alles, was uv braucht
Bei Librus Synergia registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Schlüssel eintragen
In den Einstellungen von Librus Synergia ist LIBRUS_USERNAME, LIBRUS_PASSWORD leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
KI-Chat in Cursor im Agent-Modus öffnen
Ausprobieren
Nutze Librus Synergia und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Cursor sagt, dass es Librus Synergia nutzt, oder ein Werkzeug von Librus Synergia in der Antwort zeigt, bist du verbunden
1 optionale Einstellung(en) (geht auch ohne)
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
LIBRUS_ALIASKurzname für diesen Login in Tool-Aufrufen.· Standard librusEnglisches Original anzeigen
Short name for this login in tool calls.
Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit VS Code, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Librus Synergia (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
Von der KI installieren lassen
Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Librus Synergia für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "servers": { "librus": { "type": "stdio", "command": "uvx", "args": [ "librus-mcp" ], "env": { "LIBRUS_USERNAME": "your-value", "LIBRUS_PASSWORD": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei LIBRUS_USERNAME, LIBRUS_PASSWORD "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Librus Synergia wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
uv installieren (falls noch nicht vorhanden)
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
uv --version- Eine Versionsnummer wie uv … = installiert, diesen Schritt überspringen
- "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
So öffnest du das Terminal
Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst
Download-Seite von uv öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen:
uv --versionEinmal installieren, gilt für alles, was uv braucht
Bei Librus Synergia registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Mit diesem Button VS Code öffnen
VS Code fragt nach einer Bestätigung; klicke Install
Schlüssel eintragen
In den Einstellungen von Librus Synergia ist LIBRUS_USERNAME, LIBRUS_PASSWORD leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
KI-Chat in VS Code im Agent-Modus öffnen
Ausprobieren
Nutze Librus Synergia und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn VS Code sagt, dass es Librus Synergia nutzt, oder ein Werkzeug von Librus Synergia in der Antwort zeigt, bist du verbunden
1 optionale Einstellung(en) (geht auch ohne)
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
LIBRUS_ALIASKurzname für diesen Login in Tool-Aufrufen.· Standard librusEnglisches Original anzeigen
Short name for this login in tool calls.
Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Für Entwickler: Terminal-Befehle und JSON-Einstellungen
Auf deinem Computer installiert
Claude Code
claude mcp add --scope user librus --env LIBRUS_USERNAME=your-value --env LIBRUS_PASSWORD=your-value -- uvx librus-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"librus": {
"command": "uvx",
"args": [
"librus-mcp"
],
"env": {
"LIBRUS_USERNAME": "your-value",
"LIBRUS_PASSWORD": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"librus": {
"command": "uvx",
"args": [
"librus-mcp"
],
"env": {
"LIBRUS_USERNAME": "your-value",
"LIBRUS_PASSWORD": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"librus": {
"type": "stdio",
"command": "uvx",
"args": [
"librus-mcp"
],
"env": {
"LIBRUS_USERNAME": "your-value",
"LIBRUS_PASSWORD": "your-value"
}
}
}
}Werte, die du selbst einträgst
LIBRUS_USERNAMEgeheim erforderlich envLibrus Synergia login.LIBRUS_PASSWORDgeheim erforderlich envLibrus Synergia password.LIBRUS_ALIASenvKurzname für diesen Login in Tool-Aufrufen.Englisches Original anzeigen
Short name for this login in tool calls.
Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
Auf einen Blick
- Downloads pro Wochei
- 589/Wo.
- Verbindung
- Läuft auf deinem Computer
- Neueste Versioni
- 2.9.0
- Kategoriei
- Spiele, Sport, Essen & Lernen
- In der Registry veröffentlichti
- 17. Nov. 2026
- Code zuletzt geänderti
- 17. Nov. 2026
- Entwickler
- krzysztofbury
- Pakete
pypi: librus-mcpoci: ghcr.io/krzysztofbury/librus-mcp:2.9.0mcpb: …/librus-mcp-2.9.0.mcpb- Registry-Status
- Aktiv
Welche Apps ihn nutzen können
Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.
Laufen auf deinem Computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Was er kann
Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.
Basischecksi
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026
- ✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto krzysztofbury bestätigt, dem das Repo gehört
- ✓ Bestanden
Wird noch gepflegt
Code zuletzt geändert: vorgestern
- ✓ Bestanden
Hat eine Lizenz
Nutzt MIT
- – Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
- – Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
- … Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen
Veröffentlichte Schwachstellen (OSV.dev)
Noch nicht geprüft
Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README
Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.
[](https://mcp.popnx.com/en/servers/krzysztofbury-librus-mcp)Diskussion
Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.
Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.
Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.
Nutzerbewertungen
Noch keine Bewertungen
Im Vergleich mit anderen in Spiele, Sport, Essen & Lerneni
- Mehr Sterne als 97 % der anderen 1619 Server in dieser Kategorie
- Neuer in der Registry veröffentlicht als 92 % der anderen 1619 Server in dieser Kategorie
- Basischecks gleich gut wie oder besser als bei 99 % der anderen 1619 Server in dieser Kategorie
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Häufige Fragen
Ist Librus Synergia sicher?
Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Welche Schlüssel oder Codes braucht er?
Das musst du eintragen: LIBRUS_USERNAME, LIBRUS_PASSWORD
Läuft er auf meinem Computer oder in der Cloud?
Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).
Wird er noch gepflegt?
Das GitHub-Repo wurde zuletzt vorgestern geändert, und die neueste Version (2.9.0) kam vorgestern in die Registry.
Welche Apps können ihn nutzen?
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Python (uv), Docker, MCPB auf deinem Computer.
Was kann ich stattdessen nutzen?
In derselben Kategorie: Anime Garden, WilmAI, Lumify Sports Intelligence, Savecraft, GoodWatch
Ähnliche Alternativen
Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.
So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
WilmAI
Finland's Wilma school system for parents and students: schedule, homework, exams and messages.
Lumify Sports Intelligence
Schedules, scores, odds, splits & explainable AI bet confidence — 8+ sports, free instant key.
Savecraft
Savecraft serves real save game data and expert game knowledge to AI assistants.
GoodWatch
Find movies and TV shows, track watches, and get suggestions based on your taste.
| Dieser Librus Synergia | Anime Garden | WilmAI | Lumify Sports Intelligence | Savecraft | GoodWatch | |
|---|---|---|---|---|---|---|
| Läuft wo | Wird auf deinem Rechner installiert | Läuft in der Cloud, keine Installation | Wird auf deinem Rechner installiert | Läuft in der Cloud, keine Installation | Läuft in der Cloud, keine Installation | Läuft in der Cloud, keine Installation |
| Braucht Schlüssel | Ja | Nein | Nein | Ja | Nein | Nein |
| Mit + in Claude hinzufügen | Nein | Nein | Nein | Nein | Nein | Nein |
| Basisprüfungen | 3/3 | 4/4 | 3/3 | 4/4 | 3/4 | 4/4 |
| Lizenz | MIT | AGPL-3.0 | MIT | MIT | Apache-2.0 | MIT |
| Preis | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register |
README vom Entwickler
README öffnen
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
Librus MCP Server
An MCP server that gives AI assistants access to the Librus Synergia school gradebook: grades, attendance, timetable, homework, calendar, announcements, messages, formative assessments, school-year history, class-free days and student information. It supports several logins at once, built on the independent librus-python-api.
Version 2.0 replaces the librus-apix backend used by every earlier version. Upgrading from 1.x? See Upgrading from 1.x.
Quick start
The commands below pin 2.8.1, using the native API 1.10.1. You need your Librus Synergia login and password. Accounts that require interactive two-factor authentication are not supported.
Pick one way to run it:
| Way | Best for | Credentials |
|---|---|---|
| On your computer | Claude Code, Claude Desktop, Gemini CLI, Codex, OpenCode, Hermes on the same machine | a private config.json, any number of logins |
| Desktop bundle | one-click install in apps that support MCP Bundles | the app's settings form, one login |
| Self-hosted with Docker | agents on another machine of yours, connecting over HTTP | a private config.json or environment, any number of logins |
| MCP Registry | clients that install servers from the official registry | the client's settings form, one login |
All of them run the server on a machine you control. It connects only to Librus; see Privacy.
On your computer
You do not need to clone this repository or install Python yourself. uv downloads Python 3.14 and the server automatically.
1. Install uv. On macOS or Linux, open a terminal and run:
curl -LsSf https://astral.sh/uv/install.sh | sh
On Windows, open PowerShell and run:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Close and reopen your AI assistant afterwards.
2. Create a private configuration file. Save this as config.json in a private folder under your user account, outside projects and synchronized folders, and fill in the login and password:
{
"accounts": [ {"alias": "daughter", "username": "12345", "password": "YOUR_PASSWORD"} ] }
The alias is the short name you use when asking about this login. For more logins, add more objects to accounts, each with its own alias:
{
"accounts": [ {"alias": "anna", "username": "12345", "password": "FIRST_PASSWORD"}, {"alias": "jan", "username": "67890", "password": "SECOND_PASSWORD"} ] }
Suggested locations:
- macOS:
/Users/YOUR_NAME/.config/librus-mcp/config.json - Linux:
/home/YOUR_NAME/.config/librus-mcp/config.json - Windows:
C:\Users\YOUR_NAME\.config\librus-mcp\config.json
On first start the server restricts the file to your user (macOS/Linux), creates its private state directory (~/.librus-mcp) and a persistent key there. There is nothing else to set up. Notifications and attachment downloads are on by default; sending messages is off; opening a received message marks it read without asking. To change that, add for example:
"features": {"notifications": true, "attachments": false, "send_message": true, "mark_read_consent": true}
For a single login you can skip the file and set environment variables instead: LIBRUS_USERNAME, LIBRUS_PASSWORD and optionally LIBRUS_ALIAS (default librus). Installers that collect settings in a form use these.
3. Connect your assistant. Replace the path with your file's absolute path.
Claude Code:
claude mcp add --scope user --transport stdio librus \
-- uvx --python 3.14 librus-mcp==2.8.1 --config /absolute/path/to/config.json
Claude Desktop (Settings > Developer > Edit Config):
{
"mcpServers": { "librus": { "command": "uvx", "args": ["--python", "3.14", "librus-mcp==2.8.1", "--config", "/absolute/path/to/config.json"] } } }
Gemini CLI:
gemini mcp add --scope user --transport stdio \
librus uvx --python 3.14 librus-mcp==2.8.1 --config /absolute/path/to/config.json
OpenAI Codex CLI:
codex mcp add librus \
-- uvx --python 3.14 librus-mcp==2.8.1 --config /absolute/path/to/config.json
OpenCode:
opencode mcp add librus --global -- \
uvx --python 3.14 librus-mcp==2.8.1 --config /absolute/path/to/config.json
Hermes Agent (~/.hermes/config.yaml):
mcp_servers:
librus: command: "uvx" args: ["--python", "3.14", "librus-mcp==2.8.1", "--config", "/absolute/path/to/config.json"]
Check the setup without contacting Librus:
uvx --python 3.14 librus-mcp==2.8.1 --config /absolute/path/to/config.json --check-config
If a GUI assistant cannot find uvx, use its absolute path (which uvx or where uvx). Restart or reconnect the assistant after changing the file.
Desktop bundle (preview)
Each release attaches librus-mcp-2.8.1.mcpb to its GitHub release. Open it with an app that supports MCP Bundles, such as Claude Desktop. The app asks for the Librus login and password, keeps them in its settings, and installs Python 3.14 and the exact dependency versions this release was tested with. The bundle serves one login; use On your computer for several.
Self-hosted with Docker
Run the server on your own Docker host and connect agents on other machines over HTTP. Every request needs a bearer token. The server has no TLS of its own, so expose it only through a reverse proxy with TLS or a private network such as Tailscale or WireGuard. Never publish the port on a public or shared network.
1. Prepare a private folder on the Docker host with the configuration and a token. The files must belong to the user that runs the container and be readable only by it:
mkdir -p ~/librus-mcp/data && cd ~/librus-mcp
config.json: the same format as above, any number of logins
docker run --rm ghcr.io/krzysztofbury/librus-mcp:2.8.1 --generate-token > token chmod 600 config.json token
2. Start it with this compose.yaml, replacing 1000:1000 with the output of id -u and id -g:
services:
librus-mcp: image: ghcr.io/krzysztofbury/librus-mcp:2.8.1 command: ["--transport", "http", "--allowed-host", "librus-mcp.example.lan:*"] user: "1000:1000" environment: LIBRUS_CONFIG: /config/config.json LIBRUS_MCP_TOKEN_FILE: /config/token volumes:
- ./config.json:/config/config.json:ro
- ./token:/config/token:ro
- ./data:/data ports:
Loopback for a reverse proxy on this host, or your VPN address instead.
- "127.0.0.1:8000:8000" restart: unless-stopped
docker compose up -d
docker compose logs librus-mcp
The endpoint is /mcp at your proxy's HTTPS address, or at your VPN address on port 8000. --allowed-host lists the host names clients use; NAME:* accepts NAME with any port or none. A reverse proxy must forward the original Host header: Caddy and Traefik do by default, nginx needs proxy_set_header Host $host;. Without --allowed-host the server logs that Host header checks are off and relies on the token alone. In the image the server listens on every container interface; the ports: line decides who can reach it. ./data keeps the private state, persistent key and downloads, so back it up.
3. Connect your agent with the token as a bearer header. For Hermes Agent:
mcp_servers:
librus: url: "https://librus-mcp.example.lan/mcp" headers: Authorization: "Bearer YOUR_TOKEN"
Other clients that support streamable HTTP take the same URL and header.
Things to know about HTTP mode:
- One token grants every configured login. Run one deployment per trusted person, and replace the token if it leaks.
- Let one agent poll notifications for each login: delivery and acknowledgement are designed for a single consumer.
download_attachmentsaves files on the Docker host under./data/downloads. A remote agent cannot read that path; small files (up to 256 KiB) are also offered as a short-lived MCP resource.- If you enable
send_message, anyone with the token can confirm a send preview. The server warns about this at startup. - Without a
user:line the container runs as uid 10001; a named volume then works as is, but the configuration and token files must belong to uid 10001. - Instead of files,
LIBRUS_ACCOUNTS(a JSON list of accounts), orLIBRUS_USERNAMEandLIBRUS_PASSWORDfor one login, andLIBRUS_MCP_TOKENcan be passed as environment variables.
The same image also runs over stdio for a client on the Docker host: docker run -i --rm -v librus-mcp-data:/data -e LIBRUS_USERNAME -e LIBRUS_PASSWORD ghcr.io/krzysztofbury/librus-mcp:2.8.1.
MCP Registry
The server is listed in the official MCP Registry as io.github.krzysztofbury/librus-mcp, with the PyPI package, the container image and the desktop bundle. Clients that install from the registry ask for LIBRUS_USERNAME and LIBRUS_PASSWORD, and optionally LIBRUS_ALIAS.
Upgrading from 1.x
Change the version in your assistant's configuration to librus-mcp==2.8.1, add --python 3.14 before it and keep your existing --config file. On first start 2.0 adapts the old setup automatically: it creates the key, restricts shared 1.x folders to your user, ignores the removed behaviour-notes setting and adopts 1.x notification history on the first check. Stop 1.x server processes that use the same folders before switching, and copy the state folder first: going back to 1.x is not supported other than by restoring that copy (see the migration guide).
Notifications and attachments stay on by default, as in 1.x. Tool names and results changed on purpose (for example list_students is now list_accounts and student_alias is account_alias). Assistants read the new tool list automatically; custom scripts must follow the migration guide.
Tools and safety
The default catalog has 32 typed tools:
- Accounts/profile:
list_accounts,get_student_information. - Grades:
get_grades,get_final_grades,get_grades_window. - Attendance:
get_attendance,get_attendance_window,get_attendance_detail,get_attendance_frequency,get_subject_frequency. - School:
get_timetable,get_announcements,get_agenda,get_agenda_detail,get_homework,get_homework_detail,get_completed_lessons,get_school_year_archive,get_class_free_days,get_justifications(parent logins). - Communication:
get_messages,get_message_content,get_recipient_types,get_recipient_choices,get_recipients,get_message_correspondents,get_teacher_subjects,get_message_unread_counts. - Notifications:
get_new_notifications,get_notification_status,acknowledge_notifications(featurenotifications). - Files:
download_attachmentand runtime-only attachment resources (featureattachments).
Enabling the send_message feature adds preview_message, send_message, get_send_outcome and get_send_history, for 36 tools. Disabling notifications and attachments leaves 28 tools.
Collections are paged with limit and a cursor; an announcements page also ends early when long texts would exceed the result size cap (reason: "size_limit"). Every login is independent, including logins for the same student. Modern messaging is the default; set `"me