Google-Flights-MCP-Server

by opspawn
Verified

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을 사용하여 서버를 직접 실행할 수 있습니다.

python server.py

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

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

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

{ "mcpServers": { "google-flights": { "command": "/path/to/your/.venv/bin/python", // Use absolute path to venv python "args": [ "/absolute/path/to/flight_mcp_server/server.py" // Use absolute path to server script ], "env": {}, "disabled": false, "autoApprove": [] } // ... other servers } }

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

노트

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

이 MCP 서버는 AI 비서가 Google Flights를 사용하여 온라인으로 항공편 정보를 검색할 수 있도록 합니다. 특정 날짜의 항공편을 찾거나, 여러 날짜를 검색하여 모든 옵션을 찾거나, 가장 저렴한 옵션만 찾을 수 있습니다.

  1. Features
    1. Setup
      1. Running the Server
        1. Integrating with MCP Clients (e.g., Cline, Claude Desktop)
          1. Notes
            ID: 2gtyt12ucq