Servidor Amadeus MCP

Este es un servidor de Protocolo de Contexto de Modelo (MCP) que se conecta a la API de Amadeus para proporcionar capacidades de búsqueda, reserva y análisis de vuelos para asistentes de IA.

Características

• Búsqueda de vuelos : Encuentra vuelos entre aeropuertos con varios parámetros

• Información del aeropuerto : Busque aeropuertos por palabra clave, ciudad o país

• Análisis de precios : obtenga métricas de precios de las rutas para determinar si los precios actuales son altos o bajos

• Fechas más baratas : Encuentra las fechas más económicas para viajar

• Detalles del vuelo : Obtenga información detallada sobre ofertas de vuelos específicas

Indicaciones

El servidor proporciona varias indicaciones preconfiguradas para escenarios comunes de planificación de viajes:

1. Analizar precios de vuelos ( analyze-flight-prices ): Analice los precios de los vuelos de una ruta con información sobre las tendencias de precios.

2. Encuentra las mejores ofertas ( find-best-deals ): Encuentra las mejores ofertas de vuelos para una ruta y fecha específicas

3. Planificar viaje a varias ciudades ( plan-multi-city-trip ): planifique un itinerario completo de varias ciudades con una ruta óptima

4. Encuentra las fechas de viaje más baratas ( find-cheapest-travel-dates ): Identifica las fechas más económicas para viajar

Configuración

Prerrequisitos

• Node.js 16.x o superior

• Credenciales de la API de Amadeus (ID de cliente y secreto)

Instalación

1. Clonar el repositorio:

2. Instalar dependencias:

3. Cree un archivo .env en el directorio raíz con sus credenciales de API de Amadeus:

Ejecución del servidor

Construya e inicie el servidor:

Para desarrollo:

Pruebas y desarrollo

Este proyecto utiliza Jest para pruebas y Biome para revisión y formateo.

Ejecutar pruebas unitarias:

Ejecutar pruebas con el modo de observación:

Ejecutar pruebas con cobertura:

Ejecutar pruebas de integración (requiere credenciales de API de Amadeus):

Ejecutar linting:

Código de formato:

Pruebas de integración

El proyecto incluye pruebas de integración exhaustivas que verifican la interacción del servidor con la API real de Amadeus. Estas pruebas ayudan a garantizar que nuestros clientes API funcionen correctamente con los endpoints API reales y gestionen las respuestas adecuadamente.

Requisitos para las pruebas de integración

• Credenciales de API de Amadeus : las pruebas requieren credenciales de API de Amadeus válidas en el archivo .env :

  AMADEUS_CLIENT_ID=your_client_id AMADEUS_CLIENT_SECRET=your_client_secret

• Entorno de prueba : las pruebas están configuradas para utilizar el entorno de prueba de Amadeus, no la API de producción.

Ejecución de pruebas de integración

Las pruebas de integración se encuentran en __tests__/integration y validan las siguientes características de la API:

• Búsqueda de aeropuertos : búsqueda de aeropuertos por código o palabra clave

• Búsqueda de vuelos : Encuentra vuelos de ida y vuelta

• Análisis de precios : obtención de métricas de precios para rutas específicas

Mejores prácticas para pruebas de integración

1. Límites de velocidad de la API : Las pruebas incluyen la gestión automática de límites de velocidad con reducción exponencial para evitar la limitación de la API. Al ejecutar pruebas con frecuencia, es posible que aún se encuentre con límites de velocidad.

2. Pruebas condicionales : las pruebas están diseñadas para omitirse automáticamente si faltan las credenciales de API, lo que permite que el conjunto de pruebas se ejecute sin errores en entornos sin credenciales.

3. Prueba de aislamiento : al desarrollar una nueva función, puede ejecutar archivos de prueba específicos:

   npx jest __tests__/integration/flight-search.test.js

4. Tiempos de espera más largos : las pruebas de integración utilizan tiempos de espera más largos (60 segundos) para adaptarse a la latencia de la red y los reintentos.

5. Simulación para CI/CD : para procesos de integración continua donde no está disponible el acceso a la API real, utilice __tests__/amadeus-mock.test.js que se ejecuta sin llamadas a la API reales.

Integración

Para utilizar este servidor MCP con la API de Asistente de OpenAI u otros sistemas de IA compatibles, configure el asistente para que se conecte al punto final de este servidor.

Herramientas

El servidor proporciona las siguientes herramientas:

search-flights

Busque ofertas de vuelos entre dos ubicaciones.

search-airports

Busque aeropuertos por palabra clave, nombre de ciudad o código IATA.

flight-price-analysis

Obtenga métricas de precios de una ruta de vuelo para determinar si los precios actuales son altos o bajos.

get-flight-details

Obtenga información detallada sobre una oferta de vuelo específica.

find-cheapest-dates

Encuentre las fechas más baratas para volar para una ruta determinada.

Recursos

El servidor proporciona recursos de esquema para:

• Ofertas de vuelos ( schema://flight-offers )

• Aeropuertos ( schema://airports )

Licencia

Instituto Tecnológico de Massachusetts (MIT)