librus-mcp

Lokaler, schreibgeschützter MCP-Server für ein Librus-Portal-Konto. Er verwendet den Anmeldevorgang im Portal, um ein kurzlebiges Librus-API-Token für ein gewähltes Synergia-Konto zu erhalten.

Sicherheitsmodell

• Zugangsdaten werden ausschließlich aus LIBRUS_EMAIL und LIBRUS_PASSWORD gelesen.

• Cookies und Tokens werden im Arbeitsspeicher gehalten und verworfen, wenn der Prozess beendet wird oder librus_logout aufgerufen wird.

• Der Server erlaubt HTTPS-Anfragen nur an portal.librus.pl und api.librus.pl.

• Er stellt eine Allowlist von schreibgeschützten API-Ressourcen bereit; er kann keine Nachrichten senden, Benachrichtigungen als gelesen markieren oder beliebige Anfragen absenden.

• Er schreibt bewusst keine Anfragen, Antworten, Zugangsdaten, Tokens oder API-Payloads nach stdout/stderr. Stdout ist für den MCP-Protokollverkehr reserviert.

Legen Sie keine Zugangsdaten in package.json, in eine in Git eingecheckte MCP-Konfiguration oder in eine versionskontrollierte .env-Datei ab.

Related MCP server: moodle-utn-mcp

Installation und Build

cd /home/xadix0wy/librus-mcp
npm install
npm run build

Konfigurieren eines MCP-Hosts

Verwenden Sie Umgebungsvariablen in der privaten Konfiguration oder im Secret Store des Hosts:

{
  "mcpServers": {
    "librus": {
      "command": "node",
      "args": ["/home/xadix0wy/librus-mcp/dist/index.js"],
      "env": {
        "LIBRUS_EMAIL": "your-email@example.com",
        "LIBRUS_PASSWORD": "your-password"
      }
    }
  }
}

LIBRUS_CLIENT_ID ist optional. Der Standardwert ist die öffentliche Client-ID aus dem alten Librus-Mobile-Flow. Er wird nicht als Geheimnis behandelt.

Werkzeuge

• librus_profiles: Listet die Synergia-Konten auf, die mit dem Portal-Konto verknüpft sind.

• librus_get: Liest Noten, Anwesenheit, Stundenplan, Hausaufgaben, Benachrichtigungen, Schulinformationen und weitere unterstützte API-Ressourcen. Übergeben Sie account_login aus librus_profiles.

• librus_logout: Verwirft alle im Arbeitsspeicher gehaltenen Authentifizierungsdaten.

Das Portal kann reCAPTCHA oder eine Kontoaktion anfordern. In diesem Fall stoppt der Server mit einer klaren Fehlermeldung; führen Sie die erforderliche Aktion direkt unter https://portal.librus.pl oder in der offiziellen App aus und versuchen Sie es erneut.

Kompatibilität

Dieser Ansatz basiert auf einem undokumentierten Portal-/API-Flow, der im Quellcode der alten Szkolny-Android-App beobachtet wurde. Librus kann diesen ohne Ankündigung ändern oder einschränken. Er ist ausschließlich für den Kontoinhaber gedacht und sollte in Übereinstimmung mit den Librus-Bedingungen und der Schulordnung verwendet werden.