db-timetable-mcp

Ein Model Context Protocol (MCP) Server für die Deutsche Bahn Timetable API. Der Server bietet MCP-Tools und -Ressourcen, um auf Fahrplandaten, Stationsinformationen und Zugänderungen zuzugreifen.

Pflicht zur Namensnennung:

Dieses Projekt stellt die Fahrplandaten der Deutschen Bahn bereit, die unter der Creative Commons Attribution 4.0 International Lizenz (CC BY 4.0) öffentlich einsehbar sind.

Weitere Infos zur API und Lizenzbedingungen findest du unter developers.deutschebahn.com. API Requests unterliegen den Bedingungen der Lizenz.

Funktionen

• Aktuelle Fahrplände: Abrufen aktueller Fahrplandaten für eine Station
• Fahrplanänderungen: Tracking der neuesten Änderungen
• Geplante Fahrpläne: Zugriff auf geplante Fahrplandaten für einen bestimmten Zeitpunkt
• Stationssuche: Suche nach Bahnhofsstationen anhand von Namen oder Codes

Voraussetzungen

• Node.js 18 oder höher
• API-Zugangsdaten für die DB Timetable API (Client-ID und Client-Secret)

Installation

1. Repository klonen:

   git clone <repository-url>
   cd db-mcp
   

2. Abhängigkeiten installieren:

   npm install
   

3. TypeScript-Code kompilieren:

   npm run build
   

Konfiguration

Erstelle eine .env-Datei im Root-Verzeichnis des Projekts mit folgenden Umgebungsvariablen:

DB_TIMETABLE_CLIENT_ID=deine-client-id
DB_TIMETABLE_CLIENT_SECRET=dein-client-secret
TRANSPORT_TYPE=stdio
PORT=8080
SSE_ENDPOINT=/sse
LOG_LEVEL=info

Konfigurationsoptionen

• DB_TIMETABLE_CLIENT_ID: Client-ID für die DB API (erforderlich)
• DB_TIMETABLE_CLIENT_SECRET: Client-Secret für die DB API (erforderlich)
• TRANSPORT_TYPE: Transporttyp für den MCP-Server (stdio oder sse, Standard: stdio)
• PORT: Port für den SSE-Server (Standard: 8080)
• SSE_ENDPOINT: Endpunkt für SSE-Verbindungen (Standard: /sse)
• LOG_LEVEL: Logging-Level (debug, info, warn, error, Standard: info)

Verwendung

Server starten

Im stdio-Modus (für CLI-Tests und Debugging):

npm start

Im SSE-Modus (für Webclients):

TRANSPORT_TYPE=sse npm start

Mit Inspect-Modus testen

Der Server kann mit dem FastMCP Inspector getestet werden:

npx fastmcp inspect path/to/index.js

MCP-Tools

Der Server stellt folgende Tools bereit:

1. getCurrentTimetable: Ruft aktuelle Fahrplandaten für eine Station ab

   • Parameter: evaNo - EVA-Nummer der Station (z.B. 8000105 für Frankfurt Hbf)

2. getRecentChanges: Ruft aktuelle Änderungen für eine Station ab

   • Parameter: evaNo - EVA-Nummer der Station (z.B. 8000105 für Frankfurt Hbf)

3. getPlannedTimetable: Ruft geplante Fahrplandaten für eine Station ab

   • Parameter:
     • evaNo - EVA-Nummer der Station (z.B. 8000105 für Frankfurt Hbf)
     • date - Datum im Format YYMMDD (z.B. 230401 für 01.04.2023)
     • hour - Stunde im Format HH (z.B. 14 für 14 Uhr)

4. findStations: Sucht nach Stationen anhand eines Suchmusters

   • Parameter: pattern - Suchmuster (z.B. "Frankfurt" oder "BLS")

MCP-Ressourcen

Der Server stellt folgende Ressourcen bereit:

1. Aktuelle Fahrplandaten: db-api:timetable/current/{evaNo}
2. Aktuelle Fahrplanänderungen: db-api:timetable/changes/{evaNo}
3. Geplante Fahrplandaten: db-api:timetable/planned/{evaNo}/{date}/{hour}
4. Stationssuche: db-api:station/{pattern}

Entwicklung

Projekt-Struktur

db-mcp/
├── src/
│   ├── api/             # API-Client und Typen
│   ├── tools/           # MCP-Tools
│   ├── resources/       # MCP-Ressourcen
│   ├── utils/           # Hilfsfunktionen
│   ├── config.ts        # Konfiguration
│   └── index.ts         # Haupteinstiegspunkt
├── dist/                # Kompilierte Dateien
├── .env                 # Umgebungsvariablen
├── package.json
├── tsconfig.json
└── README.md

NPM-Skripte

• npm run build: Kompiliert den TypeScript-Code
• npm start: Startet den Server
• npm run dev: Startet den Server im Entwicklungsmodus mit automatischem Neuladen
• npm test: Führt Tests aus

Erweiterbarkeit

Potenzielle Erweiterungen

1. Datenverarbeitung und -anreicherung
   • Semantische Fahrplandatenverarbeitung: XML zu strukturiertem JSON mit semantischer Anreicherung
   • Historische Datenanalyse für Verspätungen und Betriebsstörungen
   • Integration multimodaler Verkehrsverbindungen
2. Erweiterte MCP-Tools
   • Routenplanung zwischen Stationen
   • KI-basierte Verspätungs- und Auslastungsprognosen
   • Reisestörungsanalyse
   • Barrierefreiheitscheck für Stationen und Verbindungen

Lizenz

MCP Server: MIT Lizenz

DB Timetable API: Creative Commons Namensnennung 4.0 International Lizenz