mcp-server-public-transport
An MCP-compatible 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 and Belgium, 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 | ✅ |
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 | ✅ |
Setup
Environment Variables
Set the following environment variables:
Usage with Claude Desktop
Add to your claude_desktop_config.json`:
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
Setting up Development Environment
- Clone the repository
- Install dependencies
- Set environment variables
- Run the server
Running Tests
The project uses pytest for testing with the following commands available:
Code Quality
Continuous Integration
The project includes a GitHub Actions workflow (.github/workflows/test.yml
) that automatically:
- Runs tests on Python 3.10, 3.11, and 3.12
- Executes linting checks using ruff
- Runs on every push and pull request to
main
branch
The CI pipeline ensures code quality and compatibility across supported Python versions before any changes are merged.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
The package is deployed automatically to PyPI when project.version is updated in pyproject.toml
.
Follow semver for versioning.
License
This server cannot be installed
mcp-server-public-transport is an open-source, locally hosted server providing an interface for accessing public transport data across Europe.