Servidor MCP de horarios de base de datos

Un servidor de Protocolo de Contexto de Modelo (MCP) para la API de horarios de Deutsche Bahn. El servidor proporciona herramientas y recursos MCP para acceder a datos de horarios, información de estaciones y cambios de trenes.

Obligación de nombrar:

Este proyecto proporciona datos de horarios de Deutsche Bahn, que están disponibles públicamente bajo la licencia Creative Commons Atribución 4.0 Internacional (CC BY 4.0) .

Puede encontrar más información sobre la API y las condiciones de la licencia en developer.deutschebahn.com . Las solicitudes de API están sujetas a los términos de la licencia.

Funciones

• Horarios actuales : recupera datos de horarios actuales de una estación
• Cambios de horario : Seguimiento de los últimos cambios
• Horarios planificados : acceso a datos de horarios planificados para una hora específica
• Búsqueda de estaciones : busca estaciones de tren por nombre o código

Requisitos

• Node.js 18 o superior
• Credenciales de API para la API de DB Timetable (ID de cliente y secreto de cliente)

instalación

1. Repositorio de clones:
   git clone <repository-url> cd db-mcp
2. Instalar dependencias:
   npm install
3. Compilar código TypeScript:
   npm run build

configuración

Cree un archivo .env en el directorio raíz del proyecto con las siguientes variables de entorno:

Opciones de configuración

• DB_TIMETABLE_CLIENT_ID : ID de cliente para la API de base de datos (obligatorio)
• DB_TIMETABLE_CLIENT_SECRET : Secreto del cliente para la API de base de datos (obligatorio)
• TRANSPORT_TYPE : Tipo de transporte para el servidor MCP ( stdio o sse , predeterminado: stdio )
• PORT : Puerto para el servidor SSE (predeterminado: 8080 )
• SSE_ENDPOINT : Punto final para conexiones SSE (predeterminado: /sse )
• LOG_LEVEL : Nivel de registro ( debug , info , warn , error , predeterminado: info )

usar

Iniciar servidor

En modo stdio (para pruebas y depuración de CLI):

En modo SSE (para clientes web):

Prueba con el modo Inspeccionar

El servidor se puede probar con el Inspector FastMCP:

Herramientas MCP

El servidor proporciona las siguientes herramientas:

1. getCurrentTimetable : recupera los datos del horario actual de una estación
   • Parámetro: evaNo - Número EVA de la estación (p. ej., 8000105 para Frankfurt Hbf)
2. getRecentChanges : recupera los cambios recientes de una estación
   • Parámetro: evaNo - Número EVA de la estación (p. ej., 8000105 para Frankfurt Hbf)
3. getPlannedTimetable : recupera datos de horarios planificados para una estación
   • Parámetro:
     • evaNo - Número EVA de la estación (p. ej. 8000105 para Frankfurt Hbf)
     • date - Fecha en formato AAMMDD (p. ej. 230401 para 01.04.2023)
     • hour - hora en formato HH (p. ej. 14 para las 2 p.m.)
4. findStations : busca estaciones utilizando un patrón de búsqueda
   • Parámetro: pattern - patrón de búsqueda (p. ej., "Frankfurt" o "BLS")

Recursos de MCP

El servidor proporciona los siguientes recursos:

1. Datos del horario actual : db-api:timetable/current/{evaNo}
2. Cambios de horario actuales : db-api:timetable/changes/{evaNo}
3. Datos del horario planificado : db-api:timetable/planned/{evaNo}/{date}/{hour}
4. Búsqueda de estación : db-api:station/{pattern}

Desarrollo

Estructura del proyecto

Scripts de NPM

• npm run build : compila el código TypeScript
• npm start : inicia el servidor
• npm run dev : inicia el servidor en modo de desarrollo con recarga automática
• npm test : ejecuta pruebas

Extensibilidad

Posibles extensiones

1. Procesamiento y enriquecimiento de datos
   • Procesamiento de datos de horarios semánticos: XML a JSON estructurado con enriquecimiento semántico
   • Análisis de datos históricos para detectar retrasos e interrupciones
   • Integración de conexiones de transporte multimodal
2. Herramientas MCP avanzadas
   • Planificación de rutas entre estaciones
   • Previsiones de retrasos y capacidad basadas en IA
   • Análisis de interrupciones de viajes
   • Comprobación de accesibilidad para estaciones y conexiones

Licencia

Servidor MCP: Licencia MIT

API de horarios de DB: Licencia Creative Commons Atribución 4.0 Internacional