VRR MCP Server

Stellt VRR-Fahrplandaten (Essen, Bochum, Duisburg, Mülheim, Oberhausen, Gelsenkirchen etc.) als MCP-Tools für Claude bereit:

• vrr_departures – Abfahrtstafel für eine Haltestelle
• vrr_trip – Route von A nach B
• vrr_trip_via – Route von A nach B mit Zwischenstopp C
• vrr_disruptions – allgemeine Störungsübersicht im VRR-Netz

Nutzt den kostenlosen VRR-Testserver, laut VRR-Nutzungsbedingungen ohne Anmeldung erlaubt für Hobby-/Test-/Entwicklungszwecke.

Lizenz

Alle Rechte vorbehalten. Siehe LICENSE. Keine Weiterverwendung ohne Erlaubnis des Rechteinhabers.

Deployment auf FastMCP Cloud

1. Dieses Repository auf GitHub pushen.
2. Bei fastmcp.app (Prefect Horizon) mit GitHub anmelden.
3. Repository verknüpfen → automatisches Deployment.
4. Du bekommst eine öffentliche URL mit fertig eingerichtetem OAuth.

In Claude eintragen

Die URL trägst du bei Claude als Custom Connector ein (Einstellungen → Konnektoren → Custom Connector hinzufügen). Danach stehen dir die vier Tools in jedem Chat zur Verfügung – auch in der Mobile App.

Lokal testen

pip install -r requirements.txt
python server.py

Hinweise

• Der VRR-Testserver kann laut Doku gelegentlich unplausible Daten liefern (VRR nutzt ihn auch intern für Tests).
• Für dauerhaften/zuverlässigen Betrieb: kurze Mail mit Projektbeschreibung an opendata-oepnv@vrr.de für Zugang zum Produktivserver, dann VRR_BASE in server.py anpassen.
• Freitext-Ortsangaben werden intern immer zuerst über den StopFinder-Request in eine eindeutige ID aufgelöst.
• vrr_disruptions ohne Filter kann sehr viele Meldungen liefern (>1000); omc (Gemeindeschlüssel) oder limit nutzen, um sinnvoll einzugrenzen.