Buscar vuelos Servidor MCP

Servidor MCP para buscar y recuperar información de vuelos mediante la API de Duffel.

Cómo funciona

Demostración en vídeo

https://github.com/user-attachments/assets/c111aa4c-9559-4d74-a2f6-60e322c273d4

Por qué esto es útil

Aunque herramientas como Google Flights funcionan de maravilla para viajes sencillos, esta herramienta destaca al gestionar planes de viaje complejos. Aquí te explicamos por qué:

• Memoria contextual : Claude recuerda todas tus búsquedas de vuelos anteriores en el chat, por lo que no necesitas mantener varias pestañas abiertas para comparar precios
• Búsqueda de fecha flexible : Busque fácilmente en varios días para encontrar los mejores precios sin tener que verificar manualmente cada fecha.
• Itinerarios complejos : perfectos para viajes de varias ciudades, vuelos con una sola escala o cuando necesitas comparar diferentes opciones de ruta, ¡simplemente puedes preguntar!
• Conversación natural : simplemente describe lo que estás buscando: ya no tendrás que hacer clic en interfaces de calendario ni hacer malabarismos con parámetros de búsqueda para analizar nombres de ciudades, fechas y horas.

Piense en ello como si tuviera un agente de viajes en su chat que recuerda todo lo que han discutido y puede buscar instantáneamente fechas y rutas.

Características

• Buscar vuelos entre múltiples destinos
• Soporte para consultas de vuelos de ida, de ida y vuelta y de varias ciudades
• Información detallada de la oferta de vuelos
• Parámetros de búsqueda flexibles (horarios de salida, clase de cabina, número de pasajeros)
• Gestión automática de conexiones de vuelos
• Busque vuelos con varios días de antelación para encontrar el mejor vuelo para su viaje (más lento)

Prerrequisitos

• Python 3.x
• Clave activa de la API de Duffel

Cómo obtener su clave API de Duffel

Duffel requiere verificación de cuenta y configuración de información de pago, pero este servidor MCP solo usa la API para buscar vuelos: no se realizarán reservas ni cargos reales a su cuenta.

Prueba primero duffel_test para comprobar la eficacia de esta herramienta. Si te convence, puedes seguir el proceso de verificación a continuación para usar la clave activa.

Modo de prueba primero (recomendado)

Puede comenzar con una clave API de prueba ( duffel_test ) para probar la funcionalidad con datos simulados antes de pasar por el proceso de verificación completo:

1. Visita la página de registro de Duffel
2. Crea una cuenta (puedes seleccionar "Uso personal" para el nombre de la empresa)
3. Vaya a Más > Desarrollador para encontrar su clave API de prueba (ya se proporciona una)

Obtener una clave API en vivo

Para acceder a datos de vuelo reales, siga estos pasos:

1. En el panel de Duffel, desactive el "Modo de prueba" en la esquina superior izquierda.
2. El proceso de verificación requiere varios pasos: deberá desactivar el modo de prueba repetidamente:
   • Primer cambio: Verifique su dirección de correo electrónico
   • Alternar de nuevo: Información completa de la empresa (uso personal está bien)
   • Alternar nuevamente: Agregar información de pago (requerida por Duffel pero este servidor MCP NO REALIZARÁ CARGOS)
   • Alternar nuevamente: Complete los pasos de verificación restantes
   • Último interruptor: Acceda al modo en vivo después de hacer clic en "Aceptar y enviar".
3. Una vez que esté completamente verificado, vaya a Más > Desarrollador > Crear token en vivo
4. Copia tu clave API en vivo

💡 CONSEJO: Cada vez que completes un paso de verificación, tendrás que desactivar el modo de prueba para continuar con el siguiente. Sigue desactivándolo hasta que hayas completado todos los requisitos.

⚠️ NOTAS IMPORTANTES:

• Su información de pago es manejada directamente por Duffel y no es accedida ni almacenada por el servidor de MCP.
• Este servidor MCP es de SOLO LECTURA: solo puede buscar vuelos, no reservarlos.
• No se realizarán cargos a su método de pago a través de esta integración.
• Toda la información confidencial (incluidas las claves API) permanece local en su máquina
• Puede comenzar con la clave API de prueba ( duffel_test ) para evaluar la funcionalidad
• El proceso de verificación puede tardar algún tiempo: este es un requisito estándar de Duffel

Nota de seguridad

Este servidor MCP solo utiliza los puntos de búsqueda de Duffel y no puede realizar reservas ni cargos. Su información de pago es únicamente para el proceso de verificación de Duffel y nunca se accede ni se comparte con el servidor MCP.

Nota sobre los límites de uso de la API

• Consulte los precios actuales y los límites de uso de Duffel
• Diferentes niveles disponibles según sus necesidades.
• Se recomienda revisar los precios actuales en su sitio web.

Instalación

Instalación mediante herrería

Para instalar Find Flights para Claude Desktop automáticamente a través de Smithery :

Instalación manual

Clonar el repositorio:

Instalar dependencias usando uv:

Nota: Usamos uv en lugar de pip ya que el proyecto usa pyproject.toml para la gestión de dependencias.

Configurar como servidor MCP

Para agregar esta herramienta como servidor MCP, modifique el archivo de configuración del escritorio Claude.

Ubicaciones de los archivos de configuración:

• MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• Ventanas: %APPDATA%/Claude/claude_desktop_config.json

Agregue la siguiente configuración a su archivo JSON:

⚠️ IMPORTANTE:

• Reemplace YOUR_USERNAME con su nombre de usuario actual del sistema
• Reemplace your_duffel_live_api_key_here con su clave API de Duffel Live real
• Asegúrese de que la ruta del directorio coincida con su instalación local

Despliegue

Edificio

Prepare el paquete:

Esto creará distribuciones en el directorio dist/ .

Depuración

Para obtener la mejor experiencia de depuración, utilice el Inspector MCP:

El Inspector proporciona:

• Monitoreo de solicitudes y respuestas en tiempo real
• Validación de entrada/salida
• Seguimiento de errores
• Métricas de rendimiento

Herramientas disponibles

1. Buscar vuelos

Admite tres tipos de vuelos:

• Vuelos de ida
• Vuelos de ida y vuelta
• Vuelos multiciudad

Los parámetros incluyen:

• type : Tipo de vuelo ('solo ida', 'ida y vuelta', 'varias ciudades')
• origin : Código del aeropuerto de origen
• destination : Código del aeropuerto de destino
• departure_date : Fecha de salida (AAAA-MM-DD)
• Parámetros opcionales:
  • return_date : Fecha de regreso para viajes de ida y vuelta
  • adults : Número de pasajeros adultos
  • cabin_class : Clase de cabina preferida
  • departure_time : rango de hora de salida específico
  • arrival_time : Rango de tiempo de llegada específico
  • max_connections : Número máximo de conexiones

2. Obtener detalles de la oferta

Recupera detalles completos de una oferta de vuelo específica utilizando su identificación única.

3. Buscar vuelos multiciudad

Herramienta especializada para itinerarios de vuelos complejos entre múltiples ciudades.

Los parámetros incluyen:

• segments : Lista de segmentos de vuelo
• adults : Número de pasajeros adultos
• cabin_class : Clase de cabina preferida
• max_connections : Número máximo de conexiones

Casos de uso

Algunos ejemplos (¡Pruébelo usted mismo!)

Puede utilizar estas herramientas para encontrar vuelos con distintas complejidades:

• Encuentra un vuelo de ida de San Francisco a Nueva York el 7 de enero para dos adultos en clase ejecutiva.
• Busco un vuelo de ida y vuelta de Los Ángeles a Londres, con salida el 8 de enero y regreso el 15 de enero.
• Planifique un viaje a varias ciudades: de Nueva York a París el 7 de enero, luego a Roma el 10 de enero y de regreso a Nueva York el 15 de enero.
• "¿Cuál es el vuelo más barato de SFO a LAX del 7 al 15 de enero para 2 adultos en clase económica?"
• Incluso puedes buscar vuelos con varios días de antelación para encontrar el mejor vuelo para tu viaje. Por ahora, se recomienda buscar solo vuelos de ida o de ida y vuelta de esta manera. Ejemplo: "Encuentra el vuelo más barato de SFO a LAX del 7 al 10 de enero para 2 adultos en clase económica".

Formato de respuesta

Las herramientas devuelven respuestas en formato JSON con:

• Detalles de la oferta de vuelo
• Información de precios
• Detalles de la ruta
• Información del transportista
• Detalles de la conexión

Manejo de errores

El servicio incluye un manejo robusto de errores para:

• Errores en las solicitudes de API
• Códigos de aeropuerto no válidos
• Claves API faltantes o no válidas
• Tiempos de espera de la red
• Parámetros de búsqueda no válidos

Contribuyendo

[Añadir pautas para la contribución, si corresponde]

Licencia

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

Notas de rendimiento

• Las búsquedas están limitadas a 50 ofertas para vuelos de ida o de ida y vuelta.
• Las búsquedas multiciudad están limitadas a 10 ofertas
• El tiempo de espera del proveedor se establece entre 15 y 30 segundos según el tipo de búsqueda.

Clases de cabina

Clases de cabina disponibles:

• economy : Clase económica estándar
• premium_economy : Clase económica premium
• business : Clase ejecutiva
• first : Primera clase

Ejemplo de solicitud con clase de cabina: