DNDzgz MCP Server

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.

Installation

1. Clone the repository:

git clone https://github.com/danilat/mcp-dndzgz.git
cd mcp-dndzgz

2. Install dependencies:

npm install

Running the Application

Add a the environment variable with a valid google maps api key

GOOGLE_MAPS_API_KEY=your-api-key

To start the server:

npm start

Or 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.

Available Tools

The server provides the following tools:

1. 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

2. zaragoza-tram-stations: Get a list of all tram stations in Zaragoza

   • Parameters:
     • latitude (number): Latitude to sort stations by proximity
     • longitude (number): Longitude to sort stations by proximity
   • Returns: JSON with station information including location, name, and ID

3. zaragoza-bus-stops: Get all bus stops in Zaragoza

   • Parameters:
     • latitude (number): Latitude to sort stops by proximity
     • longitude (number): Longitude to sort stops by proximity
   • Returns: JSON with bus stop locations, names, IDs, and lines

4. 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

5. zaragoza-bizi-stations: Get all Bizi stations in Zaragoza (public bicycle rental service)

   • Parameters:
     • latitude (number): Latitude to sort stations by proximity
     • longitude (number): Longitude to sort stations by proximity
   • Returns: JSON with Bizi station locations, names, and IDs

6. 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

7. google-maps-link: Get a Google Maps link for a specific location

   • Parameters:
     • latitude (number): Latitude of the location
     • longitude (number): Longitude of the location
   • Returns: Google Maps URL showing the specified location

8. 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

Dependencies

• @modelcontextprotocol/sdk: ^1.9.0

Example

There is an screenshot with example using Claude Desktop

!Screenshot of an example using Claude Desktop, asking in spanish to get the tram estimations for Romareda station

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!