schoolpass-mcp

MCP-Server für SchoolPass – lesen UND ändern Sie die Ankunft und Entlassung Ihres Kindes von einem Elternkonto aus. Spricht mit der SchoolPass-REST-API, die von den SchoolPass-Web- und Mobil-Apps verwendet wird, und authentifiziert sich serverseitig mit Ihrer eigenen Eltern-E-Mail und Ihrem Passwort (kein Browser, keine Erweiterung).

Entwickelt und gepflegt von KI (Claude Code). Verwenden Sie es nach eigenem Ermessen.

Elternbezogen: Lesetools plus ein bestätigungsgeschützter Schreib-/Abbruchvorgang für Entlassungsänderungen.

Tools

Konfiguration

So finden Sie Ihre Schul-ID und den Regionshost: Melden Sie sich im Portal Ihrer Schule unter <school>.school-pass.net an, öffnen Sie die neue SchoolPass-App und lesen Sie appCode (die ID) und apiUrl (den Host) aus dem localStorage des Browsers.

Installation

{
  "mcpServers": {
    "schoolpass": {
      "command": "npx",
      "args": ["-y", "schoolpass-mcp"],
      "env": {
        "SCHOOLPASS_EMAIL": "you@example.com",
        "SCHOOLPASS_PASSWORD": "your-password",
        "SCHOOLPASS_SCHOOL_CODE": "1183"
      }
    }
  }
}

Hinweise

• Nur Elternbereich. Ein Eltern-Token kann keine Admin-Routen erreichen (Besucherverwaltung, Carline-Betrieb, Berichte, Busrouting); diese geben 403 zurück.

• Lehnen Sie eine abgelehnte Anmeldung niemals erneut ab. SchoolPass schützt seine Anmeldung mit reCAPTCHA; wiederholte Fehlversuche können dazu führen, dass das Konto herausgefordert wird.

• Keine Anmeldedaten, startet trotzdem. Der Server startet ohne Konfiguration und beantwortet tools/list; der Konfigurationsfehler erscheint beim ersten Tool-Aufruf.

Ohne den Server: curl

Die SchoolPass-API ist serverseitig erreichbar, sodass ein einmaliger Shell-Read keinen MCP-Prozess benötigt – siehe die gebündelte schoolpass-curl-Fähigkeit (skills/schoolpass-curl/) für eine Reihe von curl- und jq-Rezepten.

Entwicklung

npm install
npm test            # unit + boot tests
npm run build       # tsc + esbuild bundle
node --env-file=.env scripts/live-check.mjs   # live read-only check (needs .env)

Lizenz

MIT