# 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](./LICENSE). Keine Weiterverwendung
ohne Erlaubnis des Rechteinhabers.

## Deployment auf FastMCP Cloud

1. Dieses Repository auf GitHub pushen.
2. Bei [fastmcp.app](https://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

```bash
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.