MyCourseVille MCP Server

Ein MCP-Server, der einem KI-Agenten Zugriff auf dein MyCourseVille-Konto gewährt: neue Aufgaben mit ihren Fristen und Beschreibungen, Kursmaterialien und veröffentlichte Noten – plus einen „Was hat sich seit dem letzten Mal geändert?“-Feed.

Ein persönliches Werkzeug für deine eigenen Kontodaten. Halte das Polling-Intervall moderat und committe niemals deine Zugangsdaten.

So funktioniert es

MCV hat eine offizielle OAuth2-API (/api/v1/public/get/*), aber dafür muss man eine App registrieren, um an client_id/client_secret zu gelangen, und ihre Endpunktnamen sind nicht öffentlich dokumentiert. Dieser Server meldet sich stattdessen genau so an, wie es der MCV-Webclient tut – standardmäßig über den IT-Chula-SSO-Button, sonst über das einfache MCV-Formular – und liest dieselben servergerenderten Kursseiten, die auch der Browser geliefert bekommt: die Kursübersicht für Materialien, /assignment für Fristen und /portfolio-<student id> für Noten. Siehe docs/ENDPOINTS.md.

Die abgerufenen Daten landen in einem lokalen SQLite-Snapshot. Jede Synchronisation erzeugt einen Diff gegen diesen Snapshot und schreibt in ein events-Log – dieses Log liest whats_new, damit der Server dir mitteilen kann, was seit deinem letzten Blick neu aufgetaucht ist. Ein Hintergrund-Poller aktualisiert in einem bestimmten Intervall, sodass eine neue Aufgabe auch dann bemerkt wird, wenn gerade kein Chat geöffnet ist.

Zu „neu“: MCV legt keinen zuverlässigen Zeitstempel für die Veröffentlichung eines Objekts offen. Deshalb ist first_seen – der Zeitpunkt, zu dem dieser Server ein Element zum ersten Mal gesehen hat – der Stellvertreter. Die allererste Synchronisation befüllt alles unauffällig nach, statt dein gesamtes Semester als neu zu melden.

Related MCP server: UofT Student Helper MCP Server

Setup

uv sync --extra dev
cp .env.example .env      # then fill in MCV_USERNAME / MCV_PASSWORD
uv run mcv-mcp --selftest

--selftest meldet sich an, synchronisiert einmal und gibt aus, wie viele Kurse, Aufgaben, Materialien und Noten gefunden wurden. Bring das zum Laufen, bevor du den Agenten anbindest.

Registrieren bei Claude Code:

claude mcp add mcv -- uv --directory C:\Users\velys\Documents\mcp_mcv run mcv-mcp

Dann frag: „Was ist diese Woche fällig?“, „Gibt es etwas Neues bei ‚If MCV seit gestern?“, „Lade die neuesten Folien für Comp Prog herunter.“

Werkzeuge

Konfiguration

Der Zustand wird außerhalb des Repositories gehalten. Cookies werden gespeichert, sodass nach einem Neustart keine erneute Anmeldung nötig ist.

Führe den Poller separat (z. B. im Taskplaner) aus mit:

uv run python -m mcv_mcp.poller

Aufbau

src/mcv_mcp/
  config.py    settings, URLs, state paths
  client.py    Chula SSO login, cookie persistence, throttled AJAX transport
  parsers.py   HTML -> dicts (pure functions, fixture-tested)
  store.py     SQLite snapshot + event log
  sync.py      orchestration + background poller
  server.py    MCP tool definitions

MCVs Markup ist der fragileteil, und er ist auf parsers.py eingegrenzt. Wenn etwas plötzlich keine Zeilen mehr zurückgibt, nimm eine frische Fixture (siehe docs/ENDPOINTS.md) auf und korrigiere den Selektor dort.

Status

Getestet mit einem echten Konto: Login, alle vier Parser, Downloads und Änderungserkennung sind Ende-zu-Ende verifiziert. Eine repräsentative Synchronisation lieferte 9 Kurse, 20 Aufgaben (alle mit geparster Frist bzw. Deadline), 112 Materialien und 69 benotete Einträge; die Folgesynchronisation meldete keine Änderungen – das Diff-Log bleibt also ruhig, bis sich tatsächlich etwas bewegt.

Bekannte Grenzen:

• Die Notenveröffentlichung wird durch Polling erkannt, nicht öffentlich. Ein erscheinender Punkt taucht innerhalb eines Poll-Intervalls (Standard 30 Minuten) als Ereignis grade_changed auf.

• Es wird nur das aktuelle Semester synchron is synchronisiert, es sei du du mit sync_now das full=true mitgibst.

• Das Markup von MCV ist der fragile Teil. Wenn ein Parser keine Zeilen mehr liefert, nimm eine Fixture auf und korrigiere den Selektor – siehe docs/ENDPOINTS.md.

Entwicklung

uv run pytest