mcp-server-public-transport

An MCP Server providing real-time public transport data across Europe.

About

mcp-server-public-transport is a Model Context Protocol (MCP)-compatible local server that provides access to public transport data across Europe. Currently, it integrates APIs from UK, Switzerland, Norway, Belgium and Berlin/Brandenburg, allowing you to retrieve train connections, live departures, and bus locations.

Feature Implementation Status

Supported Countries

| Country | API Base URL | Status | | --------------------- | ---------------------------------------------------------------- | ------ | | United Kingdom | https://transportapi.com | ✅ | | Switzerland | https://transport.opendata.ch | ✅ | | Belgium | https://api.irail.be | ✅ | | Norway | https://api.entur.io | ✅ | | Berlin/Brandenburg| https://v6.vbb.transport.rest | ✅ |

Features by Country

| Feature | API Path | Status | | --------------------- | --------------------------------------------------------------- | ------ | | United Kingdom | | | | Live Departures | /uk/train/station_timetables/{station_code}.json | ✅ | | Switzerland | | | | Search Connections | /connections | ✅ | | Station Lookup | /locations | ✅ | | Departure Board | /stationboard | ✅ | | Nearby Stations | /locations?x={lon}&y={lat} | ✅ | | Belgium | | | | Live Departures | /departures | ✅ | | Station Lookup | /stations | ✅ | | Nearby Stations | /stations/nearby | ✅ | | Norway | | | | Place Search |/geocoder/v1/autocomplete| ✅ | | Live Departures| GraphQL: stopPlace(id) { estimatedCalls(...) }|✅| |Trip Planning| GraphQL: trip(from, to, dateTime, numTripPatterns, ...) |✅| |Nearest Stops|GraphQL: nearest(latitude, longitude, maximumDistance, ...)| ✅| | Berlin/Brandenburg | | | | Location Search | /locations | ✅ | | Live Departures | /stops/:id/departures | ✅ | | Live Arrivals | /stops/:id/arrivals | ✅ | | Journey Planning | /journeys | ✅ | | Nearby Stations | /locations/nearby | ✅ |

Setup

Environment Variables

Set the following environment variables:

UK_TRANSPORT_APP_ID=your_uk_app_id
UK_TRANSPORT_API_KEY=your_uk_api_key

Usage with Claude Desktop

Add to your claude_desktop_config.json`:

{
  "mcpServers": {
    "mcp-server-public-transport": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/mcp-server-public-transport",
        "run",
        "server.py"
      ],
      "env": {
        "UK_TRANSPORT_APP_ID": "your-uk-app-id",
        "UK_TRANSPORT_API_KEY": "your-uk-api-key"
      }
    }
  }
}

Replace /ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-server-public-transport with the actual path where you've cloned the repository.

Note: You may need to put the full path to the uv executable in the command field. You can get this by running which uv on MacOS/Linux or where uv on Windows.

Development

Se

... View full README on GitHub