Google-Flights-MCP-Server

Google 항공편 MCP 서버

이 MCP 서버는 fast_flights 라이브러리를 사용하여 Google Flights 데이터와 상호 작용할 수 있는 도구를 제공합니다.

특징

다음 MCP 도구를 제공합니다.

• get_flights_on_date : 두 공항 간 특정 날짜에 이용 가능한 편도 항공편을 가져옵니다.
  • 인수: origin (str), destination (str), date (str, YYYY-MM-DD), adults (int, 선택 사항), seat_type (str, 선택 사항), return_cheapest_only (bool, 선택 사항, 기본값 False ).
• get_round_trip_flights : 특정 출발 및 복귀 날짜에 대한 이용 가능한 왕복 항공편을 가져옵니다.
  • 인수: origin (문자열), destination (문자열), departure_date (문자열, YYYY-MM-DD), return_date (문자열, YYYY-MM-DD), adults (정수, 선택 사항), seat_type (문자열, 선택 사항), return_cheapest_only (부울, 선택 사항, 기본값 False ).
• find_all_flights_in_range : 지정된 날짜 범위 내에서 이용 가능한 왕복 항공편을 찾습니다. 각 날짜 쌍에서 찾은 가장 저렴한 항공편만 반환할 수도 있습니다.
  • 인수: origin (문자열), destination (문자열), start_date_str (문자열, YYYY-MM-DD), end_date_str``min_stay_days 문자열, YYYY-MM-DD), 최소_숙박_일(정수, 선택 사항), max_stay_days (정수, 선택 사항), adults (정수, 선택 사항), seat_type (문자열, 선택 사항), return_cheapest_only (부울, 선택 사항, 기본값 False ).

설정

1. 저장소를 복제합니다.지엑스피1
2. 가상 환경을 만듭니다(권장):
   python -m venv .venv source .venv/bin/activate # On Windows use `.venv\Scripts\activate`
3. 종속성 설치:
   pip install -r requirements.txt
4. Playwright 브라우저를 설치하세요( fast_flights 에 필요):
   playwright install

서버 실행

Python을 사용하여 서버를 직접 실행할 수 있습니다.

서버는 기본적으로 STDIO 전송을 사용합니다.

MCP 클라이언트(예: Cline, Claude Desktop)와 통합

MCP 클라이언트 구성 파일에 서버를 추가합니다. cline_mcp_settings.json 또는 claude_desktop_config.json 파일의 예는 다음과 같습니다.

중요: command 및 args 의 경로를 가상 환경의 Python 실행 파일과 시스템의 server.py 스크립트에 대한 절대 경로로 바꾸세요.

노트

• 이 서버는 핵심 항공편 스크래핑 기능을 위해 fast_flights 라이브러리(원래 https://github.com/AWeirdDev/flights 에서 가져옴)를 번들로 제공합니다. 자세한 내용은 포함된 LICENSE 파일을 참조하세요.
• Google Flights 변경 사항 및 네트워크 상태에 따라 항공편 스크래핑이 불안정하거나 느릴 수 있습니다. 이 도구에는 기본적인 오류 처리 기능이 포함되어 있습니다.
• find_all_flights_in_range 도구는 많은 날짜 조합을 확인하므로 리소스를 많이 사용할 수 있습니다.