Google Flights MCP Server

호스팅형 Model Context Protocol(MCP) 서버로, Claude, Cursor, Windsurf 및 기타 모든 MCP 클라이언트에 Google Flights 도구 하나를 제공합니다. 요금, 항공 구간, 탄소 배출량, 가격 기록을 포함한 편도, 왕복, 다구간 일정을 구조화된 JSON으로 검색할 수 있으며, Google 계정도, 우회해야 할 사용 중단된 여행 API도 필요 없습니다.

https://mcp.hasdata.com/api/mcp?apis=google_travel_flights

목차

• 필요한 것

• 빠른 시작

• 예시 프롬프트

• 도구

• 오류 및 실패 경로

• 요금, 무료 체험 및 제한

• 도구 선택

• 다른 서비스와 비교

• FAQ

• HasData 링크

• 개발

• 기여

• 라이선스

Related MCP server: Find Flights MCP Server

필요한 것

MCP 클라이언트와 대시보드에서 만든 HasData API 키가 필요합니다. 카드 없이 무료로 만들 수 있고, 무료 체험판은 15크레딧 기준으로 약 66회의 호출을 지원합니다. 이것은 원격 서버이므로 가장 간단한 방법은 URL과 x-api-key 헤더를 사용하는 것입니다. 실행해야 할 컨테이너도 없고, 흐름 어디에도 Google 계정이 필요 없습니다. stdio만 지원하는 클라이언트는 얇은 런처launcher를 통해 접속하며, 이 런처는 npm에 @hasdata/google-flights-mcp, PyPI에 hasdata-google-flights-mcp로 배포되어 있으며 아래에서 보여 줍니다.

빠른 시작

서버 URL은 모든 클라이언트에서 동일합니다. Claude Code와 Claude Desktop에서 직접 실행했습니다. 다른 블록들은 각 클라이언트가 원격 서버에 대해 문서화한 형식을 따릅니다.

OAuth를 지원하는 클라이언트는 같은 URL을 커넥터로 추가하고, 구성 파일에 키를 입력하지 않고도 로그인할 수 있습니다.

claude mcp add --transport http google-flights "https://mcp.hasdata.com/api/mcp?apis=google_travel_flights" \
  --header "x-api-key: HASDATA_API_KEY"

설정(Settings)에서 Connectors로 이동한 다음 Add custom connector를 선택하고, https://mcp.api.com/api/mcp?apis=google_travel_flights를 붙여넣은 뒤 로그인합니다.

구성 파일 방식으로는 Claude Desktop은 로컬(stdio) 서버만 로드하므로 원격 서버에 stdio 런처로 접속해야 합니다. 그 런처가 바로 @hasdata/google-flights-mcp 패키지이며, 환경 변수에서 키를 읽습니다. claude_desktop_config.json에 다음을 추가하세요:

{
  "mcpServers": {
    "google-flights": {
      "command": "npx",
      "args": ["-y", "@hasdata/google-flights-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

Node 대신 Python을 쓴다면 런처를 PyPI용 패키지로 바꾸면 되고, uvx가 수동 설치 없이 실행합니다:

{
  "mcpServers": {
    "google-flights": {
      "command": "uvx",
      "args": ["hasdata-google-flights-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

~/.cursor/mcp.json은 모든 프로젝트에, .cursor/mcp.json는 단일 프로젝트에 사용합니다:

{
  "mcpServers": {
    "google-flights": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=google_travel_flights",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

~/.codeium/windsurf/mcp_config.json에 작성합니다. Windsurf는 url이 아니라 serverUrl이라는 필드를 사용합니다:

{
  "mcpServers": {
    "google-flights": {
      "serverUrl": "https://mcp.hasdata.com/api/mcp?apis=google_travel_flights",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

작업 공간의 .vscode/mcp.json에 작성합니다:

{
  "servers": {
    "google-flights": {
      "type": "http",
      "url": "https://mcp.hasdata.com/api/mcp?apis=google_travel_flights",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

예시 프롬프트

코드가 아니라 프롬프트입니다. 하나를 붙여넣으면 에이전트가 도구를 직접 선택합니다. 성공한 호출에는 15크레딧이 소모되므로, 각 항목에는 필요한 호출 수가 표시되어 있습니다.

9월 15일에 JFK에서 런던 히트로 공항까지 가는 오가는 항공편을 가격순으로 정렬하고, 항공사와 탄소 배출량을 포함해 가장 저렴한 세 가지를 알려 줘.

호출 한 번, 15크레딧. 요금과 구간, 배출량이 모두 함께 반환됩니다.

같은 노선인데 직항만, 비즈니스 클래스로 보고, 어떤 선택지의 탄소 배출량이 가장 낮은지 알려 줘.

호출 한 번, 15크레딧. 좌석 등급과 경유 수는 한 번의 요청에서 사용하는 필터입니다.

가격 기록상 지금 JFK→LHR 구간에 $간? 얼마? 좋은 가격인가요?

호출 한 번, 15크레딧. 응답에는 priceInsights가 포함되어 있으며, 여기에 일반적인 범위와 가격 수준이 담깁니다.

JFK-LHR 왕복, 출발 9월 15일 복귀 9월 22일, 최저가.

호출 두 번, 30크레딧. Google은 출발 옵션을 먼저 반환하고, 그중 선택한 옵션과 연결된 귀국 항공편을 두 번째 호출로 얻습니다.

왕복은 두 번의 호출이 기본 설계입니다. 첫 번째 결과는 각각 departureToken이 있는 출발 일정을 반환하고, 그 토큰을 돌려보내면 그에 맞은 귀국 항공편을 받습니다. 편도와 가격 확인은 각각 한 번의 호출입니다.

도구

유일한 도구이며 읽기 전용입니다. 아래 샘플은 실제 호출에서 일부를 가져온 것이고, 요금은 계속 변하므로 형태로만 받아들이시기 바랍니다. 도구 이름은 전체 매개 변수 목록을 포함한 엔드포인트 레퍼런스로 연결됩니다.

이 샘플은 응답 전체가 아니라 페이로드입니다. tools/call 결과는 하나의 텍스트 블록을 가지며, 그 텍스트 자체가 url, status, text, json 문자열과 함께 json 자료를 담고 있습니다. 원시 JSON-RPC 응답이라면 result.content[0].text를 파싱한 뒤 .json으로 접근합니다. 채팅 클라이언트는 이를 대신 풀어 주지만, 엔드포인트에 직접 호출하는 코드는 그렇게 하지 않습니다.

Google Flights 결과 가져오기

hasdata_google_travel_flights_getGoogleFlights

노선과 날짜에 대한 일정을 요금, 구간, 배출량, 가격 기록과 함께 반환합니다.

레퍼런스에는 includeConnections, excludeConnections, layoverDuration, outboundTimes, returnTimes, showHidden, lessEmissions, multiCityJson도 문서화되어 있습니다.

결과는 bestFlights와 otherFlights로 나뉩니다. 각 일정에는 price, type, 분 단위 totalDuration, 구간 배열 flights, carbonEmissions 진술, bookingToken이 포입니다니다. 각 구간은 departureAirport와 arrivalAirport(각각 id, name, 로컬 time 포함), duration, airline, flightNumber, airplane, legroom, travelClass, extensions 배열, 그리고 Google이 표시한 구간의 oftenDelayedFrom30Min을 담고 있습니다. 직항 일정은 구간이 하나이고, 연결편은 여러 구간입니다.

carbonEmissions는 킬로그램이 아닌 그램으로 표시됩니다. thisFlight: 433000은 433kg입니다. differencePercent는 typicalForThisRoute와 비교한 값이라서, 음수면 평균보다 배출량이 적은 항공편입니다.

{
  "price": 295,
  "type": "One way",
  "totalDuration": 415,
  "flights": [
    {
      "departureAirport": { "id": "JFK", "name": "John F. Kennedy International Airport", "time": "2026-09-15 8:15" },
      "arrivalAirport": { "id": "LHR", "name": "Heathrow Airport", "time": "2026-09-15 20:10" },
      "duration": 415,
      "airline": "Virgin Atlantic",
      "flightNumber": "VS 26",
      "airplane": "Boeing 787",
      "travelClass": "Economy"
    }
  ],
  "carbonEmissions": { "thisFlight": 367000, "typicalForThisRoute": 419000, "differencePercent": -12 },
  "bookingToken": "W1t7..."
}

priceInsights는 일정과 함께 lowestPrice, typicalPriceRange, typical 같은 priceLevel, 그리고 [timestamp, price] 지점으로 이루어진 priceHistory를 갖습니다. airports에는 해석된 출발·도착 공항이 도시와 국가 정보와 함께 반영됩니다.

오류 및 실패 경로

클라이언트가 도구 호출에서 HTTP 오류 코드를 받는 경우는 거의 없습니다. MCP 레이어는 200으로 먼저 응답하고 실패를 결과 내부에 넣으며, isError가 true로 설정되고 사유는 텍스트로 나옵니다. 상태 줄을 기대하던 자리에서 클라이언트는 메시지를 읽게 됩니다.

**잘못된 키

무료 체험판은 카드 등록 없이 30일 동인 1,000크레딧으로, 약 66회 항공편 검색에 해당합니다. 이후에도 활성 계정은 잔액이 100미만으로 떨어질 때마다 매일 100크레딧가 자동 충전되므로, 낮은 규모의 에이전트는 무료 티어에서 계속 운영할 수 있습니다.

유료 플랜은 200,000크레딧(약 13,000회 검색)에 $49/월부터 시작합니다. 단위 가격은 볼륨이 늘수록 낮아져서, 시잭 플랜의 $3.68/1,000콜에서 비즈니스 $1.49, 그로우스 $1.25, 가장 높은 대규모 플랜의 $1.12까지 내려갑니다.

플랜에 따라 동시 처리 수도 정해집니다. 무료 체험판은 동시 1요청, Startup은 15, Business는 30, Growth는 50, 그로우스위 플랜은 200~ 1,500 요청을 지원합니다. 무인 운영 중에는 넘채 요청에 대한 방어 처리를 해 두어야 합니다.

비-200 응답이 들어오면 청구되지 않습니다. 왕복 항공편은 두 번의 호출/요청이 필요하므로, 그 비을 감안하고 예산을 세우세요.

도구 선택

apis 리 파라미터는 에이전트가 보게 될 도구를 결종합니다. 도구가 적을수록 도구 정의에 소비되는 컨테스트가 줄어들고, 모델이 잘못 도구를 집을 확률도 낮아집니다.

GY

?apis=google_travel_flights          the one tool in this repo
?apis=google_travel                   add Google Hotels
?apis=google_travel_flights,airbnb    flights plus Airbnb stays

이 파라미터는 google_travel 같은 프로바이더 이름과 google_travel_flights 같은 개별 API 이름을 받습니다. 오타가 난 이름은 무시됩니다. 모든 이름이 틀리면 요청이 400으로 청부하는데, 응답 본문에는 인식하지 못한 이름과 유효한 전체 목이 함께 표시됩니다. 이 파라미터를 밠추면 동은 엔드포인트에서 HasData의 75개 도구가 모두 노출됩니다.

기존 API와 비교

Google은 2018년 QPX Express 항공 API를 종료하면서 그 뒤을 잇는 공식 API를 출시하지 않았습니다, 그래서 공식 Google Flights API는 존재하지 않습니다. 남은 방법은 공개 결과를 스크래핑하거나, 무거고 비싼 GDS 운임 데이터를 라이선스하는 것뿐입니다. 이 서버는 사이트가 보여주는 것과 동은 결과를 읽어서 JSON으로 바꿔 제공합니다.

이 서버가 하지 않는 일. 예약도 결제도 없습니다. 단지 운핑, 항공 구간, Google 자체가 예약 단계로 넘어갈 때 사는 토큰을 읽어서, 예약 단계는 사용자에게 돌려주세요.

FAQ

공식 Google Flights API가 있나요?

아니요. Google은 2018년 QPX Express를 닫고 대체제품을 내놓지 않았습니다. 모든 옵션은 웹사이트가 제공하는 같은 퍼블릭 결과를 읽습니다. 이 서버에는 HasData가 유지보수하고 있으며, 구조화된 JSON으로 반합니다.

Google Flights MCP 서버가 무언인가요?

Google Flights를 AI 클라이언트가 호출할 수 있는 도구로 노출하는 서버입니다. 클라이언트는 Model Context Protocol 로 도구 호출을 보내고, 서버는 일정표를 가져와 구조화된 JSON으로 결과를 반환하고, 모델은 그 결과로 작업합니다. 이 서버는 하나의 도구만 노출하며 원격으로 실행됩니다.

왜 왕복이 두 번의 호출인가요?

Google은 먼저 가는 편 옵션을 반환하고, 각 옵션에는 departureToken이 있습니다. 하나를 선택해서 받은 토큰을 다시 넘으면 그에 맞는 돌아오는 항공편을 얻을 수 있습니다. 이는 사이트가 동작하는 방식과 동일하며, 그래서 왕복은 30 크레딧트입니다.

탄소 배출 수치 단위를 킬로그램인가요?

아니요, 그램입니다. thisFlight: 433000은 433 kg을 의미하며, differencePercent는 노션 평균과 비교한 값입니다.

티은 검색(deep search)이 무엇인가요?

Google Flights가 브라우저에 보여주는 결과를 그대로 반환하는 느린 모드입니다. 속도가 필요하면 끄고, 사이트와 완전히 동일한 결과가 필요때 십 시오.

다른 HasData API와 함게 수 있나요?

네. apis 파라미터는 목록을 받으며, ?apis=google_travel으로 Google Flights 옆에 Google Hotes도 추갸할 수 있습니다. 파라미터를 생략하면 모든 도구가 활성화됩니다.

규정 준수 및 개인정보

HasData는 공개적으로 이용 가능한 데이터만 접근합니다. 각 플랫폼의 이용약관은 자동화된 접드를 제한할 수 있으며, 규정 준수은 사용자의 책임입니다.

HasData 링크

개버

이 리포지토리는 원격 서버를 위한 설정과 문서입니다. 빌드 스텝도 없고, 컨네이너화할 것도 없습니다행.

test/ 디렉토리의 테스트는 여기에서 커미트 없이도 변할 수 있는 도구 계약을 검증합니다. 테스트는 ?apis=google_travel_flights이 도구를 정확하 하나만 반환하는지, 필수 파라미터를 계속 명시하는지, 이을이 바지 않았는지, 사용 중인 키가 실호 인용되는지를 확입니다. 마인막 트스는 실제로 API를 호출해서 15 크레딧이 차으，맞 알맞 이류로 실패할 수 있는 카나리입니다.

# macOS and Linux
HASDATA_API_KEY=your_key_here npm test

# Windows PowerShell
$env:HASDATA_API_KEY="your_key_here"; npm test

동일한 트스 수트는 시마다 시와 주1회 예정로 CI로도 실행됩니다. 왜느냐런 상류 도구 목록은 이 저장소를 누구도 만지지 않을도 변할 수 있기 때입니다. 실패를 이는 다는 도구 목록이 이동했거나, 키가 작동하지 않거나, 엔드포인트에 도달할 수 없을 의미이며， 어서션 하나하가 무엇인을 알려줍니다.

버하하기

가장 흔용한 버하 트는 파라미터 표와 응답 샘플의 수정입니자. 왜느냐면 이러한 곳이 가장 과거가 잘 변하기 때문입니다. 호출한 내용과 받은 응답을 실어 주세요. 포크에서온 풀 리스트는 키 없이 트스 수트를 실습니다. 라이브 뱄크는 실패 대신 스킵합니다.

라이선스

MIT. LICENSE를 참조하세요.