NS Travel Information MCP Server

NS Travel Information MCP Server

¡Convierte tu asistente de IA en un experto en ferrocarriles neerlandeses! Este servidor MCP conecta a Claude con información de viaje en tiempo real de NS (Nederlandse Spoorwegen), convirtiéndolo en tu compañero perfecto para viajar en tren por los Países Bajos.

Instalación

Puedes instalar este servidor de tres maneras:

1. Usando Claude Desktop con el paquete NPM

Actualiza tu archivo de configuración de Claude (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "ns-server": {
      "command": "npx",
      "args": [
        "-y",
        "ns-mcp-server"
      ],
      "env": {
        "NS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Puedes obtener una clave API desde NS API Portal

2. Usando Smithery

Para instalar NS Travel Information Server automáticamente a través de Smithery:

npx -y @smithery/cli install ns-server --client claude

3. Desde el código fuente

1. Clona este repositorio
2. Instala las dependencias:

   npm install
   

3. Copia el archivo de entorno de ejemplo:

   cp .env.example .env
   

4. Añade tu clave API de NS al archivo .env:

   NS_API_KEY=your_api_key_here
   

Luego actualiza tu archivo de configuración de Claude:

{
  "mcpServers": {
    "ns-server": {
      "command": "node",
      "args": [
        "/path/to/ns-server/build/index.js"
      ],
      "env": {
        "NS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Asegúrate de:

1. Reemplazar /path/to/ns-server con la ruta real a tu instalación
2. Añadir tu clave API de NS en la sección env. Puedes obtenerla desde aquí https://apiportal.ns.nl/product#product=NsApp

Después de actualizar la configuración, reinicia Claude Desktop para que los cambios surtan efecto.

Casos de uso en el mundo real

• "¿Mi tren habitual de las 8:15 de Almere a Ámsterdam va a tiempo?"
• "¿Hay retrasos en la ruta Róterdam-La Haya hoy?"
• "¿Cuál es la mejor ruta alternativa a Utrecht si hay mantenimiento en la línea directa?"
• "¿Qué tren debería tomar para llegar a mi oficina en Ámsterdam Zuid antes de las 9 AM?"
• "¿Qué ruta a Ámsterdam tiene menos transbordos con un cochecito?"
• "¿Cuál es el tren más temprano que puedo tomar para llegar a mi reunión de las 10 AM en La Haya?"
• "¿Cuándo es el último tren de regreso a Groninga después de una noche en Ámsterdam?"
• "¿Hay obras de ingeniería el fin de semana que puedan afectar mi clase del lunes por la mañana?"
• "¿Hay bicicletas OV-fiets disponibles en Utrecht Centraal para mi reunión de la tarde?"
• "¿La estación Eindhoven Strijp-S es accesible en silla de ruedas y qué andenes tiene?"
• "¿Qué trenes llegan a Utrecht Centraal en la próxima hora?"
• "¿El tren de Venlo al Aeropuerto de Schiphol ha llegado a tiempo?"
• "¿Cuánto cuesta un billete de primera clase de Ámsterdam a Róterdam?"
• "¿Cuál es el precio para 2 adultos y 1 niño que viajan a La Haya?"

🔑 Variables de entorno

Variable	Descripción
NS_API_KEY	Tu clave API de NS (obligatoria)

🌟 Características

Este servidor MCP proporciona acceso completo a la información de trenes de NS a través de los siguientes endpoints:

Información de trenes en tiempo real

• Salidas: Obtén información de salidas en tiempo real, incluidos números de andén, retrasos y notas de viaje
• Llegadas: Accede a las próximas llegadas de trenes con estaciones de origen, cambios de andén y actualizaciones de estado
• Planificación de viajes: Encuentra rutas óptimas con transbordos y actualizaciones en tiempo real
• Actualizaciones de servicio: Consulta interrupciones, trabajos de mantenimiento y actividades de ingeniería

Información de precios

• Precios de billetes: Obtén precios precisos para viajes sencillos y de ida y vuelta
• Clases de viaje: Compara precios para viajes en primera y segunda clase
• Precios para grupos: Calcula tarifas para adultos y niños
• Opciones de descuento: Consulta descuentos para viajes conjuntos y ofertas especiales
• Detalles de validez: Consulta los períodos de validez de los billetes y las condiciones de viaje

Información de estaciones

• Detalles de estaciones: Accede a información completa de las estaciones, incluidos:
  • Instalaciones y características de accesibilidad
  • Distribución de andenes e información de vías
  • Disponibilidad de OV-fiets (alquiler de bicicletas)
  • Ubicación y detalles de acceso

Características adicionales

• Soporte multilingüe: Información disponible en neerlandés e inglés
• Consultas flexibles: Búsqueda por nombre de estación, código o identificador UIC
• Zonas horarias: Manejo adecuado de zonas horarias para estaciones internacionales
• Actualizaciones de estado: Seguimiento de cambios, retrasos y cancelaciones en tiempo real

Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulta el archivo LICENSE para más detalles