This is an MCP (Model Context Protocol) server that provides information about the Zaragoza tram system, including real-time tram arrival estimations and station information using the DNDzgz API.
- Clone the repository:
git clone https://github.com/danilat/mcp-dndzgz.git
cd mcp-dndzgz- Install dependencies:
npm installAdd a the environment variable with a valid google maps api key
GOOGLE_MAPS_API_KEY=your-api-keyTo start the server:
npm startOr configure in your MCP client, for example:
{
"mcpServers": {
"dndzgz": {
"command": "node",
"args": [
"/Users/danilat/workspace/mcp-dndzgz/index.js"
],
"env": {
"GOOGLE_MAPS_API_KEY": "your-api-key"
}
}
}
}The server will start and connect to the MCP transport layer.
The server provides the following tools:
-
zaragoza-tram-estimations: Get real-time arrival estimations for a specific tram station- Parameters:
station(number): ID of the tram station
- Returns: JSON with estimated arrival times for both directions
- Parameters:
-
zaragoza-tram-stations: Get a list of all tram stations in Zaragoza- Parameters:
latitude(number): Latitude to sort stations by proximitylongitude(number): Longitude to sort stations by proximity
- Returns: JSON with station information including location, name, and ID
- Parameters:
-
zaragoza-bus-stops: Get all bus stops in Zaragoza- Parameters:
latitude(number): Latitude to sort stops by proximitylongitude(number): Longitude to sort stops by proximity
- Returns: JSON with bus stop locations, names, IDs, and lines
- Parameters:
-
zaragoza-bus-estimations: Get real-time arrival estimations for a specific bus stop- Parameters:
stop(number): ID of the bus stop
- Returns: JSON with estimated arrival times for each line serving that stop
- Parameters:
-
zaragoza-bizi-stations: Get all Bizi stations in Zaragoza (public bicycle rental service)- Parameters:
latitude(number): Latitude to sort stations by proximitylongitude(number): Longitude to sort stations by proximity
- Returns: JSON with Bizi station locations, names, and IDs
- Parameters:
-
zaragoza-bizi-estimations: Get real-time availability of bikes and free slots in a Bizi station- Parameters:
station(number): ID of the Bizi station
- Returns: JSON with bikes and parking slot availability
- Parameters:
-
google-maps-link: Get a Google Maps link for a specific location- Parameters:
latitude(number): Latitude of the locationlongitude(number): Longitude of the location
- Returns: Google Maps URL showing the specified location
- Parameters:
-
geolocation-from-address: Get the geolocation (latitude and longitude) from an address and the formatted address that was found- Parameters:
address(string): The address to geolocate (e.g., "Plaza de San Francisco, Zaragoza, Spain")
- Returns: JSON with latitude, longitude, confidence level, and formatted address
- Parameters:
- @modelcontextprotocol/sdk: ^1.9.0
There is an screenshot with example using Claude Desktop