Servidor MCP de alertas en tiempo real de TfNSW

Un servidor de Protocolo de Contexto de Modelo para la API de Alertas en Tiempo Real de Transporte para NSW (TfNSW). Este servidor proporciona herramientas para acceder e interactuar con alertas e información de transporte en tiempo real mediante Modelos de Lenguaje Grandes.

Descripción general

Este servidor MCP basado en TypeScript se integra con el sistema de alertas en tiempo real de Transport for NSW. Permite a los asistentes de IA acceder a información actualizada sobre interrupciones del transporte, obras planificadas y otras alertas importantes en la red de transporte de NSW.

Related MCP server: Transport NSW API Client MCP

Características

Recursos

• Listado y acceso a alertas de transporte mediante nsw-transport://

• Filtrar alertas por modo de transporte (autobuses, trenes, ferries, etc.)

• Formato de texto simple para un fácil consumo por parte de los asistentes de IA

Herramientas

• get-transport-alerts - Recupera alertas de transporte actuales

  • Filtrar por modo de transporte

  • Devuelve información de alerta formateada, incluidas las rutas afectadas, los períodos de tiempo y los detalles del impacto.

Indicaciones

• transport-disruption-summary : genera un resumen de las alertas de transporte actuales

  • Incluye detalles de alerta relevantes como recursos integrados

  • Devuelve una solicitud estructurada para el resumen de LLM de las principales disrupciones

Modos de transporte

Se admiten los siguientes modos de transporte:

• all - Todos los modos de transporte

• buses - Servicios de autobuses del metro de Sídney y del metro exterior

• ferries - Ferries de Sydney y transbordadores de Newcastle Transport

• lightrail - Servicios de tren ligero

• metro - Metro de Sídney

• nswtrains - Trenes y autocares regionales de NSW Trains

• regionbuses - Servicios de autobuses regionales

• sydneytrains - Red suburbana e interurbana de Sydney Trains

Autenticación

Este servidor requiere autenticación con la API de Datos Abiertos de TfNSW. Deberá registrarse para obtener una clave API en el Centro de Datos Abiertos de TfNSW .

Instalación

Para utilizar con Claude Desktop, agregue la configuración del servidor:

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

En Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "tfnsw-realtime-alerts": {
      "command": "npx",
      "args": [
        "-y",
        "tfnsw-realtime-alerts-mcp-server"
      ],
      "env": {
        "NSW_TRANSPORT_API_KEY": "your_api_key_here"
      }
    }
  }
}

Reemplace "your_api_key_here" con su clave API de TfNSW del Centro de datos abiertos de TfNSW .

Desarrollo

Configure su clave API como una variable de entorno en su archivo .env :

NSW_TRANSPORT_API_KEY="your_api_key_here"

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Depuración

Puede utilizar el Inspector MCP para la depuración, que está disponible como un script de paquete:

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.