MCP 항공편 검색

모델 컨텍스트 프로토콜(MCP)을 기반으로 구축된 항공편 검색 서비스입니다. 이 서비스는 항공편 검색 기능을 위한 MCP 도구 구현 방법을 보여줍니다.

모델 컨텍스트 프로토콜이란 무엇인가요?

모델 컨텍스트 프로토콜(MCP)은 Anthropic에서 개발한 표준으로, 도구 설명, 호출 및 응답에 대한 구조화된 형식을 정의하여 AI 모델이 도구를 사용할 수 있도록 합니다. 이 프로젝트는 Claude 및 기타 MCP 호환 모델에서 사용할 수 있는 MCP 도구를 구현합니다.

Related MCP server: FlightRadar MCP Server

설치

지엑스피1

용법

MCP 서버를 시작합니다.

# Using the command-line entry point
mcp-flight-search --connection_type http

# Or run directly
python main.py --connection_type http

사용자 정의 포트를 지정할 수도 있습니다.

python main.py --connection_type http --port 5000

환경 변수

SerpAPI 키를 환경 변수로 설정합니다.

export SERP_API_KEY="your-api-key-here"

특징

항공편 검색 기능을 위한 MCP 호환 도구
SerpAPI Google Flights와 통합
편도 및 왕복 항공편 지원
구조화된 출력을 통한 풍부한 로깅
모듈식, 유지 관리 가능한 코드 구조

MCP 도구

이 패키지는 다음과 같은 모델 컨텍스트 프로토콜 도구를 제공합니다.

search_flights_tool : 다음 매개변수를 사용하여 공항 간 항공편을 검색합니다.
- origin : 출발 공항 코드(예: ATL, JFK)
- destination : 도착 공항 코드(예: LAX, ORD)
- outbound_date : 출발 날짜(YYYY-MM-DD)
- return_date : 왕복 여행의 경우 선택적인 복귀 날짜(YYYY-MM-DD)
server_status : MCP 서버가 실행 중인지 확인합니다.

프로젝트 구조

mcp-flight-search/
├── mcp_flight_search/
│   ├── __init__.py              # Package initialization and exports
│   ├── config.py                # Configuration variables (API keys)
│   ├── models/
│   │   ├── __init__.py          # Models package init
│   │   └── schemas.py           # Pydantic models (FlightInfo)
│   ├── services/
│   │   ├── __init__.py          # Services package init
│   │   ├── search_service.py    # Main flight search logic
│   │   └── serpapi_client.py    # SerpAPI client wrapper
│   ├── utils/
│   │   ├── __init__.py          # Utils package init
│   │   └── logging.py           # Logging configuration
│   └── server.py                # MCP server setup and tool registration
├── main.py                      # Main entry point
├── pyproject.toml               # Python packaging configuration
├── LICENSE                      # MIT License
└── README.md                    # Project documentation