DB Timetable MCP Server

DB Timetable MCP Server

A Model Context Protocol (MCP) server for the Deutsche Bahn Timetable API. The server provides MCP tools and resources for accessing timetable data, station information, and train changes.

Obligation to name:

This project provides Deutsche Bahn timetable data, which is publicly available under the Creative Commons Attribution 4.0 International License (CC BY 4.0) .

Further information about the API and license terms can be found at developers.deutschebahn.com . API requests are subject to the license terms.

Functions

• Current timetables : Retrieve current timetable data for a station
• Timetable changes : Tracking the latest changes
• Planned timetables : Access to planned timetable data for a specific time
• Station search : Search for train stations by name or code

Requirements

• Node.js 18 or higher
• API credentials for the DB Timetable API (client ID and client secret)

installation

1. Clone repository:
   git clone <repository-url> cd db-mcp
2. Install dependencies:
   npm install
3. Compile TypeScript code:
   npm run build

configuration

Create an .env file in the root directory of the project with the following environment variables:

Configuration options

• DB_TIMETABLE_CLIENT_ID : Client ID for the DB API (required)
• DB_TIMETABLE_CLIENT_SECRET : Client secret for the DB API (required)
• TRANSPORT_TYPE : Transport type for the MCP server ( stdio or sse , default: stdio )
• PORT : Port for the SSE server (default: 8080 )
• SSE_ENDPOINT : Endpoint for SSE connections (default: /sse )
• LOG_LEVEL : Logging level ( debug , info , warn , error , default: info )

use

Start server

In stdio mode (for CLI testing and debugging):

In SSE mode (for web clients):

Test with Inspect mode

The server can be tested with the FastMCP Inspector:

MCP tools

The server provides the following tools:

1. getCurrentTimetable : Retrieves current timetable data for a station
   • Parameter: evaNo - EVA number of the station (e.g. 8000105 for Frankfurt Hbf)
2. getRecentChanges : Retrieves recent changes for a station
   • Parameter: evaNo - EVA number of the station (e.g. 8000105 for Frankfurt Hbf)
3. getPlannedTimetable : Retrieves planned timetable data for a station
   • Parameter:
     • evaNo - EVA number of the station (e.g. 8000105 for Frankfurt Hbf)
     • date - Date in YYMMDD format (e.g. 230401 for 01.04.2023)
     • hour - hour in HH format (e.g. 14 for 2 p.m.)
4. findStations : Searches for stations using a search pattern
   • Parameter: pattern - search pattern (e.g. "Frankfurt" or "BLS")

MCP resources

The server provides the following resources:

1. Current timetable data : db-api:timetable/current/{evaNo}
2. Current timetable changes : db-api:timetable/changes/{evaNo}
3. Planned timetable data : db-api:timetable/planned/{evaNo}/{date}/{hour}
4. Station search : db-api:station/{pattern}

Development

Project structure

NPM scripts

• npm run build : Compiles the TypeScript code
• npm start : Starts the server
• npm run dev : Starts the server in development mode with automatic reloading
• npm test : Runs tests

Extensibility

Potential extensions

1. Data processing and enrichment
   • Semantic timetable data processing: XML to structured JSON with semantic enrichment
   • Historical data analysis for delays and disruptions
   • Integration of multimodal transport connections
2. Advanced MCP tools
   • Route planning between stations
   • AI-based delay and capacity forecasts
   • Travel disruption analysis
   • Accessibility check for stations and connections

License

MCP Server: MIT License

DB Timetable API: Creative Commons Attribution 4.0 International License