Google-Flights-MCP-Server

Servidor MCP de Google Flights

Este servidor MCP proporciona herramientas para interactuar con los datos de Google Flights mediante la biblioteca incluida fast_flights .

Características

Proporciona las siguientes herramientas MCP:

• get_flights_on_date : obtiene los vuelos de ida disponibles para una fecha específica entre dos aeropuertos.
  • Argumentos: origin (str), destination (str), date (str, AAAA-MM-DD), adults (int, opcional), seat_type (str, opcional), return_cheapest_only (bool, opcional, predeterminado False ).
• get_round_trip_flights : obtiene los vuelos de ida y vuelta disponibles para fechas de salida y regreso específicas.
  • Argumentos: origin (str), destination (str), departure_date (str, AAAA-MM-DD), return_date (str, AAAA-MM-DD), adults (int, opcional), seat_type (str, opcional), return_cheapest_only (bool, opcional, predeterminado: False ).
• find_all_flights_in_range : Busca vuelos de ida y vuelta disponibles dentro de un rango de fechas específico. Opcionalmente, puede devolver solo el vuelo más barato encontrado para cada par de fechas.
  • Argumentos: origin (str), destination (str), start_date_str (str, AAAA-MM-DD), end_date_str (str, AAAA-MM-DD), min_stay_days (int, opcional), max_stay_days (int, opcional), adults (int, opcional), seat_type (str, opcional), return_cheapest_only (bool, opcional, predeterminado False ).

Configuración

1. Clonar el repositorio:
   git clone https://github.com/opspawn/Google-Flights-MCP-Server.git cd Google-Flights-MCP-Server
2. Crear un entorno virtual (recomendado):
   python -m venv .venv source .venv/bin/activate # On Windows use `.venv\Scripts\activate`
3. Instalar dependencias:
   pip install -r requirements.txt
4. Instalar los navegadores Playwright (necesarios para fast_flights ):
   playwright install

Ejecución del servidor

Puedes ejecutar el servidor directamente usando Python:

El servidor utiliza el transporte STDIO de forma predeterminada.

Integración con clientes MCP (por ejemplo, Cline, Claude Desktop)

Agregue el servidor al archivo de configuración de su cliente MCP. Ejemplo para cline_mcp_settings.json o claude_desktop_config.json :

Importante: reemplace las rutas en command y args con las rutas absolutas al ejecutable de Python de su entorno virtual y al script server.py en su sistema.

Notas

• Este servidor incluye la biblioteca fast_flights (originalmente de https://github.com/AWeirdDev/flights ) para su funcionalidad principal de rastreo de vuelos. Consulte el archivo LICENSE incluido para conocer sus términos.
• El rastreo de vuelos a veces puede ser poco fiable o lento según los cambios de Google Flights y las condiciones de la red. Las herramientas incluyen gestión básica de errores.
• La herramienta find_all_flights_in_range puede consumir muchos recursos, ya que comprueba muchas combinaciones de fechas.