FlightRadar24

FlightRadar24 MCP 서버는 Flightradar24 데이터를 사용하여 실시간으로 항공편을 추적하고 관련 정보를 제공하는 서버입니다. 이 서버를 통해 LLM은 전 세계 항공편의 실시간 위치, 비행 상태, 출발 및 도착 정보, 지연 상태, 항공기 세부 정보 등에 접근할 수 있습니다. 여행 계획, 항공편 모니터링, 항공 관련 질문에 답변하는 데 매우 유용한 도구입니다.

특징

• 실시간 항공편 추적: 전 세계 비행 중인 항공편의 실시간 위치 및 상태 정보
• 상세 항공편 정보: 항공편 번호, 출발지, 목적지, 예상 도착 시간, 지연 정보 등
• 공항 정보: 공항 코드, 위치, 운영 상태, 출발 및 도착 항공편 목록
• 항공사 정보: 항공사 상세 정보, 운항 중인 항공편 목록
• 항공기 세부 사항: 항공기 유형, 등록 번호, 제조 정보, 운영 이력
• 경로 정보: 항공편 경로, 고도, 속도, 방향 등 비행 세부 정보
• 검색 기능: 항공편 번호, 공항, 지역 등으로 검색
• 통계 정보: 항공편 지연, 취소, 혼잡도 등의 통계 데이터

API

도구

항공편 추적

• track_flight: 특정 항공편 추적
• 입력: 항공편 번호 또는 등록 번호

• 출력: 실시간 위치, 고도, 속도, 방향, 출발/도착 정보

• flights_in_area: 특정 지역 내 모든 항공편 검색

• 입력: 좌표(위도, 경도), 반경 또는 바운딩 박스

• 출력: 해당 지역 내 항공편 목록

• flights_by_airline: 특정 항공사의 운항 중인 항공편 검색

• 입력: 항공사 코드 또는 이름
• 출력: 해당 항공사의 현재 운항 중인 항공편 목록

공항 및 스케줄

• airport_info: 공항 정보 조회
• 입력: IATA 또는 ICAO 공항 코드

• 출력: 공항 이름, 위치, 터미널, 상태 등

• airport_departures: 공항 출발 항공편 조회

• 입력: 공항 코드, 시간 범위(선택적)

• 출력: 출발 항공편 목록 및 상태

• airport_arrivals: 공항 도착 항공편 조회

• 입력: 공항 코드, 시간 범위(선택적)
• 출력: 도착 항공편 목록 및 상태

항공기 및 항공사

• aircraft_info: 항공기 정보 조회
• 입력: 항공기 등록 번호 또는 트랜스폰더 코드

• 출력: 항공기 유형, 제조사, 나이, 운영 항공사 등

• airline_info: 항공사 정보 조회

• 입력: 항공사 IATA 또는 ICAO 코드
• 출력: 항공사 이름, 국가, 허브 공항, 기단 크기 등

검색 및 통계

• search_flights: 항공편 검색
• 입력: 검색어(항공편 번호, 출발지-목적지, 항공사 등)

• 출력: 검색 조건에 맞는 항공편 목록

• flight_statistics: 항공편 통계 조회

• 입력: 항공편 번호 또는 경로, 날짜 범위
• 출력: 정시 출발/도착률, 평균 지연 시간, 취소율 등

사용 방법

설치

# npm을 통한 설치
npm install -g flightradar24-mcp

# 또는 Docker 이미지 사용
docker pull flightradar24/mcp-server

구성

Claude Desktop에서 이 서버를 사용하려면 다음과 같이 설정합니다:

{
  "mcpServers": {
    "flightradar24": {
      "command": "npx",
      "args": ["flightradar24-mcp"],
      "env": {
        "API_KEY": "your_flightradar24_api_key",
        "UPDATE_INTERVAL": "30",  // 정보 업데이트 간격(초)
        "MAX_RESULTS": "100"      // 최대 결과 수
      }
    }
  }
}

Docker를 사용하는 경우:

{
  "mcpServers": {
    "flightradar24": {
      "command": "docker",
      "args": ["run", "--rm", "-p", "3000:3000", "-e", "API_KEY=your_api_key", "flightradar24/mcp-server"]
    }
  }
}

필요 조건

• Node.js v14 이상 또는 Docker
• 인터넷 연결
• Flightradar24 API 키 (일부 고급 기능 사용 시 필요)
• Flightradar24 서비스 이용 약관 준수

사용 예시

// 특정 항공편 추적
const flightInfo = await track_flight("KE907");  // 대한항공 907편
console.log(`현재 위치: 위도 ${flightInfo.latitude}, 경도 ${flightInfo.longitude}`);
console.log(`고도: ${flightInfo.altitude}피트, 속도: ${flightInfo.speed}노트`);
console.log(`출발: ${flightInfo.origin.name}, 목적지: ${flightInfo.destination.name}`);
console.log(`예상 도착 시간: ${flightInfo.arrival.estimated}`);

// 특정 지역의 항공편 검색
const areaFlights = await flights_in_area({
  lat: 37.566, 
  lon: 126.978,  // 서울 좌표
  radius: 100    // 100km 반경
});
console.log(`서울 주변 ${areaFlights.length}개의 항공편이 운항 중입니다.`);

// 인천국제공항 출발 항공편 조회
const departures = await airport_departures("ICN", {
  hours: 3  // 3시간 이내 출발 예정
});
console.log(`인천국제공항에서 ${departures.length}편이 곧 출발 예정입니다.`);

// 항공사 정보 조회
const airlineInfo = await airline_info("KE");  // 대한항공
console.log(`항공사: ${airlineInfo.name}`);
console.log(`본사: ${airlineInfo.country}`);
console.log(`현재 운항 중인 항공편: ${airlineInfo.activeFlights}편`);

// 항공편 통계 조회
const stats = await flight_statistics("KE907", {
  days: 30  // 지난 30일 통계
});
console.log(`정시 출발률: ${stats.onTimeDeparture}%`);
console.log(`평균 지연 시간: ${stats.averageDelay}분`);

연결된 구성 요소

• mcp_weather - 항공편 경로 상의 날씨 정보와 통합
• Google Maps - 항공편 위치 및 경로를 지도에 시각화
• Calculator - 비행 시간, 거리, 소요 연료 등의 계산에 활용