항공편 찾기 MCP 서버

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

작동 원리

비디오 데모

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 )로 시작할 수 있습니다.

Duffel의 등록 페이지를 방문하세요
계정을 만드세요(회사 이름에 "개인용"을 선택할 수 있습니다)
테스트 API 키를 찾으려면 더 보기 > 개발자로 이동하세요(이미 제공됨).

라이브 API 키 받기

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

Duffel 대시보드에서 왼쪽 상단 모서리에 있는 "테스트 모드"를 끕니다.
검증 과정에는 여러 단계가 필요합니다. 테스트 모드를 반복해서 꺼야 합니다.
- 첫 번째 토글: 이메일 주소 확인
- 다시 토글: 회사 정보 입력(개인 용도로는 괜찮습니다)
- 다시 전환: 결제 정보 추가(Duffel에서 필요하지만 이 MCP 서버에서는 요금이 청구되지 않음)
- 다시 전환: 나머지 확인 단계를 완료하세요.
- 마지막 토글: "동의 및 제출"을 클릭한 후 라이브 모드에 액세스합니다.
완전히 검증되면 추가 > 개발자 > 라이브 토큰 만들기로 이동하세요.
라이브 API 키를 복사하세요

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

⚠️ 중요 참고 사항:

귀하의 결제 정보는 Duffel에서 직접 처리되며 MCP 서버에서 액세스하거나 저장되지 않습니다.
이 MCP 서버는 읽기 전용입니다. 즉, 항공편을 검색할 수만 있고 예약할 수는 없습니다.
이 통합을 통해 귀하의 결제 방법에는 요금이 청구되지 않습니다.
모든 민감한 정보(API 키 포함)는 사용자의 컴퓨터에 로컬로 저장됩니다.
테스트 API 키( duffel_test )로 시작하여 기능을 평가할 수 있습니다.
검증 프로세스에는 시간이 다소 소요될 수 있습니다. 이는 표준 Duffle 요구 사항입니다.

보안 참고 사항

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

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

Duffel의 현재 가격과 사용 한도를 확인하세요
귀하의 요구 사항에 따라 다양한 계층이 제공됩니다.
웹사이트에서 현재 가격을 검토하는 것이 좋습니다.

설치

Smithery를 통해 설치

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

지엑스피1

수동 설치

저장소를 복제합니다.

git clone https://github.com/ravinahp/flights-mcp
cd flights-mcp

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

uv sync

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

MCP 서버로 구성

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

구성 파일 위치:

MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
윈도우: %APPDATA%/Claude/claude_desktop_config.json

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

{
    "flights-mcp": {
        "command": "uv",
        "args": [
            "--directory",
            "/Users/YOUR_USERNAME/Code/flights-mcp",
            "run",
            "flights-mcp"
        ],
        "env": {
            "DUFFEL_API_KEY_LIVE": "your_duffel_live_api_key_here"
        }
    }
}

⚠️ 중요:

YOUR_USERNAME 실제 시스템 사용자 이름으로 바꾸세요.
your_duffel_live_api_key_here 실제 Duffel Live API 키로 바꾸세요.
디렉토리 경로가 로컬 설치와 일치하는지 확인하세요.

전개

건물

패키지를 준비하세요:

# Sync dependencies and update lockfile
uv sync

# Build package
uv build

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

디버깅

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

npx @modelcontextprotocol/inspector uv --directory /path/to/find-flights-mcp run find-flights-mcp

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

실시간 요청/응답 모니터링
입력/출력 검증
오류 추적
성과 지표

사용 가능한 도구

1. 항공편 검색

@mcp.tool()
async def search_flights(params: FlightSearch) -> str:
    """Search for flights based on parameters."""

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

편도 항공편
왕복 항공편
여러 도시로 가는 항공편

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

type : 항공편 유형('편도', '왕복', '다구간')
origin : 출발지 공항 코드
destination : 목적지 공항 코드
departure_date : 출발 날짜(YYYY-MM-DD)
선택 매개변수:
- return_date : 왕복 여행의 귀국 날짜
- adults : 성인 승객 수
- cabin_class : 선호하는 객실 등급
- departure_time : 특정 출발 시간 범위
- arrival_time : 특정 도착 시간 범위
- max_connections : 최대 연결 수

2. 제안 세부 정보 받기

@mcp.tool()
async def get_offer_details(params: OfferDetails) -> str:
    """Get detailed information about a specific flight offer."""

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

3. 다중 도시 항공편 검색

@mcp.tool(name="search_multi_city")
async def search_multi_city(params: MultiCityRequest) -> str:
    """Search for multi-city flights."""

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

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

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 : 일등석

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

{
  "params": {
    "type": "one_way",
    "adults": 1,
    "origin": "SFO",
    "destination": "LAX",
    "departure_date": "2025-01-12",
    "cabin_class": "business"  // Specify desired cabin class
  }
}

Find Flights MCP Server