DNDzgz

Servidor MCP DNDzgz

Este es un servidor MCP (Protocolo de Contexto de Modelo) que proporciona información sobre el sistema de tranvía de Zaragoza, incluyendo estimaciones de llegada de tranvías en tiempo real e información de estaciones mediante la API de DNDzgz.

Instalación

1. Clona el repositorio:

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

2. Instala las dependencias:

npm install

Ejecución de la aplicación

Añade una variable de entorno con una clave válida de la API de Google Maps y ejecútalo con el transporte HTTP.

GOOGLE_MAPS_API_KEY=your-api-key npm start:http

El servidor se iniciará; debes configurar tu cliente MCP para conectarse.

O inicia el servidor usando el transporte stdio: Configúralo en tu cliente MCP usando npx, por ejemplo:

{
    "mcpServers": {
      "dndzgz": {
        "command": "npx @dndzgz/mcp",
        "env": {
          "GOOGLE_MAPS_API_KEY": "your-api-key"
        }
      }
    }
}

El servidor se iniciará y se conectará al servidor MCP.

Herramientas disponibles

El servidor proporciona las siguientes herramientas:

1. zaragoza-tram-estimations: Obtén estimaciones de llegada en tiempo real para una estación de tranvía específica.

   • Parámetros:
     • station (número): ID de la estación de tranvía.
   • Devuelve: JSON con los tiempos de llegada estimados para ambas direcciones.

2. zaragoza-tram-stations: Obtén una lista de todas las estaciones de tranvía en Zaragoza.

   • Parámetros:
     • latitude (número): Latitud para ordenar las estaciones por proximidad.
     • longitude (número): Longitud para ordenar las estaciones por proximidad.
   • Devuelve: JSON con información de la estación, incluyendo ubicación, nombre e ID.

3. zaragoza-bus-stops: Obtén todas las paradas de autobús en Zaragoza.

   • Parámetros:
     • latitude (número): Latitud para ordenar las paradas por proximidad.
     • longitude (número): Longitud para ordenar las paradas por proximidad.
   • Devuelve: JSON con las ubicaciones de las paradas de autobús, nombres, IDs y líneas.

4. zaragoza-bus-estimations: Obtén estimaciones de llegada en tiempo real para una parada de autobús específica.

   • Parámetros:
     • stop (número): ID de la parada de autobús.
   • Devuelve: JSON con los tiempos de llegada estimados para cada línea que sirve esa parada.

5. zaragoza-bizi-stations: Obtén todas las estaciones de Bizi en Zaragoza (servicio público de alquiler de bicicletas).

   • Parámetros:
     • latitude (número): Latitud para ordenar las estaciones por proximidad.
     • longitude (número): Longitud para ordenar las estaciones por proximidad.
   • Devuelve: JSON con las ubicaciones, nombres e IDs de las estaciones de Bizi.

6. zaragoza-bizi-estimations: Obtén la disponibilidad en tiempo real de bicicletas y huecos libres en una estación de Bizi.

   • Parámetros:
     • station (número): ID de la estación de Bizi.
   • Devuelve: JSON con la disponibilidad de bicicletas y huecos de aparcamiento.

7. google-maps-link: Obtén un enlace de Google Maps para una ubicación específica.

   • Parámetros:
     • latitude (número): Latitud de la ubicación.
     • longitude (número): Longitud de la ubicación.
   • Devuelve: URL de Google Maps que muestra la ubicación especificada.

8. geolocation-from-address: Obtén la geolocalización (latitud y longitud) de una dirección y la dirección formateada que se encontró.

   • Parámetros:
     • address (cadena): La dirección a geolocalizar (p. ej., "Plaza de San Francisco, Zaragoza, España").
   • Devuelve: JSON con latitud, longitud, nivel de confianza y dirección formateada.

Dependencias

• @modelcontextprotocol/sdk: ^1.9.0

Ejemplo

Hay una captura de pantalla con un ejemplo usando Claude Desktop.