항공편 찾기 MCP 서버

Duffel API를 사용하여 항공편 정보를 검색하고 조회하기 위한 MCP 서버입니다.

작동 원리

Related MCP server: Flight Planner MCP Server

비디오 데모

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

이것이 도움이 되는 이유

Google Flights와 같은 도구는 간단한 여행에는 효과적이지만, 복잡한 여행 계획을 세울 때 더욱 빛을 발합니다. 그 이유는 다음과 같습니다.

• 상황적 메모리 : Claude는 채팅에서 이전에 검색한 모든 항공편을 기억하므로 가격을 비교하기 위해 여러 탭을 열어둘 필요가 없습니다.

• 유연한 날짜 검색 : 각 날짜를 수동으로 확인하지 않고도 여러 날짜를 쉽게 검색하여 최고의 가격을 찾을 수 있습니다.

• 복잡한 여정 : 여러 도시 여행, 경유 항공편에 적합하며, 다양한 노선 옵션을 비교해야 할 때도 문의하기만 하면 됩니다!

• 자연스러운 대화 : 찾고 있는 것이 무엇인지 설명하세요. 더 이상 달력 인터페이스를 클릭하거나 검색 매개변수를 조정하여 도시 이름, 날짜, 시간을 구문 분석할 필요가 없습니다.

채팅에 여행사가 참여해 여러분이 논의한 모든 내용을 기억하고 날짜와 경로를 즉시 검색할 수 있다고 생각해 보세요.

특징

• 여러 목적지 간 항공편 검색

• 편도, 왕복 및 다중 도시 항공편 쿼리 지원

• 자세한 항공편 제공 정보

• 유연한 검색 매개변수(출발 시간, 객실 등급, 승객 수)

• 항공편 연결 자동 처리

• 여러 날 동안 항공편을 검색하여 여행에 가장 적합한 항공편을 찾으세요(느림)

필수 조건

• 파이썬 3.x

• 더플 API 라이브 키

더플 API 키 받기

더플은 계정 확인 및 결제 정보 설정이 필요하지만, 이 MCP 서버는 항공편 검색에만 API를 사용합니다. 실제 예약이나 요금은 계정에 청구되지 않습니다.

먼저 duffel_test를 사용하여 이 도구의 성능을 확인해 보세요. 마음에 드신다면 아래 확인 절차를 거쳐 라이브 키를 사용하실 수 있습니다.

먼저 테스트 모드(권장)

전체 검증 프로세스를 거치기 전에 시뮬레이션된 데이터로 기능을 시험해 보려면 테스트 API 키( duffel_test )로 시작할 수 있습니다.

1. Duffel의 등록 페이지를 방문하세요

2. 계정을 만드세요(회사 이름에 "개인용"을 선택할 수 있습니다)

3. 테스트 API 키를 찾으려면 더 보기 > 개발자로 이동하세요(이미 제공됨).

라이브 API 키 받기

실제 비행 데이터에 액세스하려면 다음 단계를 따르세요.

1. Duffel 대시보드에서 왼쪽 상단 모서리에 있는 "테스트 모드"를 끕니다.

2. 검증 과정에는 여러 단계가 필요합니다. 테스트 모드를 반복해서 꺼야 합니다.

   • 첫 번째 토글: 이메일 주소 확인

   • 다시 토글: 회사 정보 입력(개인 용도로는 괜찮습니다)

   • 다시 전환: 결제 정보 추가(Duffel에서 필요하지만 이 MCP 서버에서는 요금이 청구되지 않음)

   • 다시 전환: 나머지 확인 단계를 완료하세요.

   • 마지막 토글: "동의 및 제출"을 클릭한 후 라이브 모드에 액세스합니다.

3. 완전히 검증되면 추가 > 개발자 > 라이브 토큰 만들기로 이동하세요.

4. 라이브 API 키를 복사하세요

💡 팁: 확인 단계를 완료할 때마다 다음 단계로 넘어가려면 테스트 모드를 다시 꺼야 합니다. 모든 요건을 충족할 때까지 계속 켜 두세요.

⚠️ 중요 참고 사항:

• 귀하의 결제 정보는 Duffel에서 직접 처리되며 MCP 서버에서 액세스하거나 저장되지 않습니다.

• 이 MCP 서버는 읽기 전용입니다. 즉, 항공편을 검색할 수만 있고 예약할 수는 없습니다.

• 이 통합을 통해 귀하의 결제 방법에는 요금이 청구되지 않습니다.

• 모든 민감한 정보(API 키 포함)는 사용자의 컴퓨터에 로컬로 저장됩니다.

• 테스트 API 키( duffel_test )로 시작하여 기능을 평가할 수 있습니다.

• 검증 프로세스에는 시간이 다소 소요될 수 있습니다. 이는 표준 Duffle 요구 사항입니다.

보안 참고 사항

이 MCP 서버는 Duffel의 검색 엔드포인트만 사용하며 예약이나 요금 청구는 하지 않습니다. 귀하의 결제 정보는 Duffel의 확인 절차에만 사용되며 MCP 서버에서 접근하거나 공유되지 않습니다.

API 사용 제한에 대한 참고 사항

• Duffel의 현재 가격과 사용 한도를 확인하세요

• 귀하의 요구 사항에 따라 다양한 계층이 제공됩니다.

• 웹사이트에서 현재 가격을 검토하는 것이 좋습니다.

설치

Smithery를 통해 설치

Smithery를 통해 Find Flights for Claude Desktop을 자동으로 설치하려면:

지엑스피1

수동 설치

저장소를 복제합니다.

uv를 사용하여 종속성을 설치합니다.

참고: 이 프로젝트는 종속성 관리를 위해 pyproject.toml을 사용하므로 pip 대신 uv를 사용합니다.

MCP 서버로 구성

이 도구를 MCP 서버로 추가하려면 Claude 데스크톱 구성 파일을 수정하세요.

구성 파일 위치:

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

• 윈도우: %APPDATA%/Claude/claude_desktop_config.json

JSON 파일에 다음 구성을 추가하세요.

⚠️ 중요:

• YOUR_USERNAME 실제 시스템 사용자 이름으로 바꾸세요.

• your_duffel_live_api_key_here 실제 Duffel Live API 키로 바꾸세요.

• 디렉토리 경로가 로컬 설치와 일치하는지 확인하세요.

전개

건물

패키지를 준비하세요:

이렇게 하면 dist/ 디렉토리에 배포판이 생성됩니다.

디버깅

최상의 디버깅 환경을 위해 MCP Inspector를 사용하세요.

검사관은 다음을 제공합니다.

• 실시간 요청/응답 모니터링

• 입력/출력 검증

• 오류 추적

• 성과 지표

사용 가능한 도구

1. 항공편 검색

3가지 비행 유형을 지원합니다.

• 편도 항공편

• 왕복 항공편

• 여러 도시로 가는 항공편

매개변수는 다음과 같습니다.

• type : 항공편 유형('편도', '왕복', '다구간')

• origin : 출발지 공항 코드

• destination : 목적지 공항 코드

• departure_date : 출발 날짜(YYYY-MM-DD)

• 선택 매개변수:

  • return_date : 왕복 여행의 귀국 날짜

  • adults : 성인 승객 수

  • cabin_class : 선호하는 객실 등급

  • departure_time : 특정 출발 시간 범위

  • arrival_time : 특정 도착 시간 범위

  • max_connections : 최대 연결 수

2. 제안 세부 정보 받기

고유 ID를 사용하여 특정 항공편 상품에 대한 포괄적인 세부 정보를 검색합니다.

3. 다중 도시 항공편 검색

복잡한 다중 도시 항공편 일정을 위한 전문 도구입니다.

매개변수는 다음과 같습니다.

• segments : 비행 구간 목록

• adults : 성인 승객 수

• cabin_class : 선호하는 객실 등급

• max_connections : 최대 연결 수

사용 사례

몇 가지 예 (하지만 직접 시도해 보세요!)

다음 도구를 사용하면 다양한 복잡성의 항공편을 찾을 수 있습니다.

• "1월 7일 SFO에서 NYC까지 비즈니스석으로 성인 2명을 위한 편도 항공편을 찾으세요"

• "1월 8일 출발, 1월 15일 복귀하는 LAX발 런던행 왕복 항공편을 검색하세요"

• "1월 7일 뉴욕에서 파리까지, 1월 10일 로마까지, 그리고 1월 15일 뉴욕으로 돌아오는 여러 도시 여행을 계획하세요."

• "1월 7일부터 1월 15일까지 성인 2명이 이코노미석을 이용하는 경우, SFO에서 LAX까지 가장 저렴한 항공편은 무엇입니까?"

• 여러 날짜 내의 항공편을 검색하여 여행에 가장 적합한 항공편을 찾을 수도 있습니다. 현재로서는 편도 또는 왕복 항공편만 이 방법으로 검색하는 것이 좋습니다. 예: "1월 7일부터 1월 10일까지 성인 2인 이코노미석 기준 샌프란시스코 국제 공항(SFO)에서 로스앤젤레스(LAX)까지 가장 저렴한 항공편을 찾아주세요"

응답 형식

이 도구는 다음과 같은 JSON 형식의 응답을 반환합니다.

• 항공편 제공 세부 정보

• 가격 정보

• 슬라이스(경로) 세부 정보

• 통신사 정보

• 연결 세부 정보

오류 처리

이 서비스에는 다음에 대한 강력한 오류 처리 기능이 포함되어 있습니다.

• API 요청 실패

• 잘못된 공항 코드

• API 키가 누락되었거나 유효하지 않습니다.

• 네트워크 시간 초과

• 잘못된 검색 매개변수입니다

기여하다

[해당되는 경우 기여에 대한 지침 추가]

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

성능 노트

• 편도/왕복 항공편의 경우 검색은 50개로 제한됩니다.

• 여러 도시 검색은 10개의 제안으로 제한됩니다.

• 공급업체 시간 초과는 검색 유형에 따라 15~30초로 설정됩니다.

객실 등급

이용 가능한 객실 등급:

• economy : 표준 이코노미 클래스

• premium_economy : 프리미엄 이코노미 클래스

• business : 비즈니스 클래스

• first : 일등석

객실 등급에 따른 요청 예시: