FlightRadar MCP Server

FlightRadar MCP Server

AviationStack API を使用して、リアルタイムのフライト追跡情報と運航状況を提供する Model Context Protocol（MCP）サーバーです。

機能

この MCP サーバーは、次の 6 つのツールを提供します。

1. get_flight_data：IATA コードまたは ICAO コードを指定して、特定のフライトに関する詳細情報を取得します
2. search_flights：航空会社、出発／到着空港、運航状況など、さまざまな条件でフライトを検索します
3. get_flight_status：特定のフライトの状況を、人が読みやすい形式で要約して取得します
4. search_airports：IATA／ICAO コードまたは空港名で、空港の参照データ（名称、所在地、タイムゾーン）を検索します
5. get_airline_info：IATA／ICAO コードまたは航空会社名で、航空会社の参照データ（名称、コード、保有機材情報）を検索します
6. get_future_flights：指定した将来の日付について、空港の出発便または到着便の予定を取得します

ツール 1～3 は、無料プランで利用できる AviationStack のリアルタイム /flights エンドポイントを使用します。ツール 4～6 は /airports、/airlines、/flightsFuture エンドポイントを使用しますが、これらの利用には有料の AviationStack プラン（Basic 以上）が必要です。無料プランのキーで呼び出すと、API から function_access_restricted エラーが返されます。

インストール

Smithery 経由でのインストール

Smithery 経由で Claude Desktop に flightradar-mcp-server を自動的にインストールするには：

npx -y @smithery/cli install @Cyreslab-AI/flightradar-mcp-server --client claude

前提条件

• Node.js（v14 以上）
• npm（v6 以上）
• AviationStack API キー（aviationstack.com で取得できます）

セットアップ

1. このリポジトリをクローンします：

   git clone https://github.com/Cyreslab-AI/flightradar-mcp-server.git
   cd flightradar-mcp-server
   

2. 依存関係をインストールします：

   npm install
   

3. サーバーをビルドします：

   npm run build
   

4. MCP 設定ファイルでサーバーを設定します：

   Claude VSCode 拡張機能の場合は、~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json に追加します：

   {
     "mcpServers": {
       "flightradar": {
         "command": "node",
         "args": ["/path/to/flightradar-mcp-server/build/index.js"],
         "env": {
           "AVIATIONSTACK_API_KEY": "YOUR_API_KEY_HERE"
         },
         "disabled": false,
         "autoApprove": []
       }
     }
   }
   

   Claude デスクトップアプリの場合は、~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または他のプラットフォームで同等のパスに追加します。

使用例

サーバーの設定が完了したら、Claude でフライト情報を取得できます。

フライト状況の取得

User: What's the status of flight BA855?

Claude: Flight BA855 (British Airways) is currently landed.

Departure: Prague Vaclav Havel Airport (PRG), Terminal 1, Gate B5
Scheduled: 3/25/2025, 11:50:00 AM
Estimated: 3/25/2025, 11:50:00 AM

Arrival: Heathrow (LHR), Terminal 3
Scheduled: 3/25/2025, 1:10:00 PM

フライトの検索

User: Find British Airways flights

Claude: I found 3212 British Airways flights. Here are the first 3:

1. BA5719: Tucson (TUS) to Dallas/Fort Worth (DFW)
   Status: scheduled
   Departure: 3/25/2025, 5:00:00 AM

2. BA6096: Prague (PRG) to Helsinki (HEL)
   Status: scheduled
   Departure: 3/25/2025, 11:40:00 AM

3. BA855: Prague (PRG) to London Heathrow (LHR)
   Status: landed
   Departure: 3/25/2025, 10:50:00 AM

フライト詳細の取得

User: Get detailed information about flight BA855

Claude: Here are the details for flight BA855:

Flight: BA855 (BAW855)
Airline: British Airways
Aircraft: Airbus A320 (Registration: G-EUUH)

Departure:
- Airport: Prague Vaclav Havel Airport (PRG/LKPR)
- Terminal: 1, Gate: B5
- Scheduled: 3/25/2025, 10:50:00 AM

Arrival:
- Airport: London Heathrow (LHR/EGLL)
- Terminal: 3
- Scheduled: 3/25/2025, 12:10:00 PM

Status: landed

空港の検索

User: What airport is LHR?

Claude: LHR is London Heathrow Airport, London, United Kingdom (ICAO: EGLL, timezone: Europe/London).

航空会社情報の取得

User: Which airline is BA?

Claude: BA is British Airways (ICAO: BAW, callsign: SPEEDBIRD), based in the United Kingdom.

将来のフライトの取得

User: What flights are scheduled to depart JFK on 2027-03-01?

Claude: Here are scheduled departures from JFK on 2027-03-01:

1. AA100 to LHR, scheduled 2027-03-01T19:00:00
2. DL1 to CDG, scheduled 2027-03-01T20:30:00

API キーの設定

このサーバーを使用するには、AviationStack API キーが必要です。aviationstack.com で無料の API キー（月 100 リクエスト）を取得できます。

API キーは、MCP 設定で AVIATIONSTACK_API_KEY という名前の環境変数として指定してください。

注：無料プランで利用できるのは、リアルタイムのフライト検索（get_flight_data、search_flights、get_flight_status）のみです。参照データ用のツール（search_airports、get_airline_info、get_future_flights）は、有料プラン（Basic 以上）が必要な AviationStack エンドポイントを呼び出します。無料プランのキーを使用すると、API エラー（function_access_restricted）が返されます。

ライセンス

MIT