mcp-dndzgz

# 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](https://www.dndzgz.com/) API. ## Installation 1. Clone the repository: ```bash git clone https://github.com/danilat/mcp-dndzgz.git cd mcp-dndzgz ``` 2. Install dependencies: ```bash npm install ``` ## Running the Application Add a the environment variable with a valid google maps api key and run it with the http transport ```bash GOOGLE_MAPS_API_KEY=your-api-key npm start:http ``` The server will start you should configure yout MCP client to connect. Or start the server using stdio trasport: Configure in your MCP client using `npx`, for example: ```json { "mcpServers": { "dndzgz": { "command": "npx @dndzgz/mcp", "env": { "GOOGLE_MAPS_API_KEY": "your-api-key" } } } } ``` The server will start and connect to the MCP server. ## 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