About Public Transport
Public Transport is an MCP server published by mirodn in the Developer Tools category: a Model Context Protocol server for Singapore transport data with real-time information and routing. It has been installed 0 times through Conduid.
The repository has 6 stars and 2 forks, with the last commit 6 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues (0) before depending on it in production.
Install
npx mcp-server-public-transportclaude mcp add public-transport -- npx -y @siva-sub/mcp-public-transportnpx -y @siva-sub/mcp-public-transportThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Public Transport
Powered by Claude · Grounded in docs
Security checks
- ·README presentNot checked yet.
- ·License declaredNot checked yet.
- ·Tests presentNot checked yet.
- ·Dependencies pinnedNot checked yet.
- ·No dynamic code executionNot checked yet.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
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
Setting up Development Environment
-
Clone the repository
git clone https://github.com/mirodn/mcp-server-public-transport.git cd mcp-server-public-transport -
Install dependencies
uv sync -
Set environment variables
cp .env.example .env -
Run the server
uv run server.py
Running Tests
The project uses pytest for testing with the following commands available:
# Run all tests
make test
Code Quality
# Run linting
make lint
# Run code formatting
make format
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
mainbranch
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
README mirrored from the source repository 24 days ago. The original is authoritative.