README.md•3.5 kB
# 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
