Flightradar24 MCP Server

Flightradar24 MCP サーバー

公式の商用 Flightradar24 API（fr24api.flightradar24.com）からフライト追跡データにアクセスできる Model Context Protocol（MCP）サーバーです。

このサーバーは以前、ドキュメント化されていない、リバースエンジニアリングされたモバイルアプリのエンドポイント （api.flightradar24.com/v1/...）を呼び出していました。現在は、正式にドキュメント化された、クレジット制の FR24 の実際の API に移行しています。変更内容については、以下の「移行に関する注意事項」をご覧ください。

機能

ツール

• get_flight_data：現在飛行中の特定のフライトのリアルタイム位置データを、フライト番号またはコールサインで取得します
• search_flights：航空会社、機体記号、機種、ルート、高度、または地理的エリアで、現在飛行中のフライトを検索します
• get_flight_summary：指定した日時の範囲内で、完了したフライトの離陸・着陸履歴を取得します
• get_flight_tracks：FR24 のフライト ID を指定して、特定のフライトの詳細な位置情報の航跡を取得します
• get_airport_data：正確な IATA または ICAO コードを指定して、空港情報を取得します
• get_airline_data：ICAO コードを指定して、航空会社名と IATA コードを取得します
• get_flights_in_zone：地理的な境界ボックス内にある、現在飛行中のすべてのフライトを取得します
• get_api_usage：エンドポイントごとの FR24 API クレジット使用状況の概要を取得します

リソース

• flight://{flight_number}：IATA または ICAO のフライト番号を指定して、現在飛行中のフライトのリアルタイム位置情報を取得します
• airport://{code}：正確な IATA または ICAO コードを指定して、空港情報を取得します
• airline://{icao}：ICAO コードを指定して、航空会社情報を取得します
• flighttrack://{flight_id}：FR24 のフライト ID を指定して、特定のフライトの詳細な位置情報の航跡を取得します
• zone://{north}/{south}/{west}/{east}：指定した地理的ゾーン内にある、現在飛行中のフライトを取得します

インストール

1. このリポジトリをクローンします
2. 依存関係をインストールします：

   npm install
   

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

   npm run build
   

FR24 API キーの取得

1. fr24api.flightradar24.com でアカウントを作成し、API プランに登録します。
2. Key Management ページでトークンを生成します。
3. FR24_API_KEY 環境変数に設定します（以下の「設定」を参照）。

料金とクレジットの概要

FR24 API は定額制ではなく、クレジット制です。各リクエストのクレジット費用は、返されるエンティティ（フライト、空港など）の数に基づき、エンティティあたりの料金はエンドポイントごとに異なります。 たとえば、Live Flight Positions（light）のクエリでは、返されるフライト 1 件あたり約 6 クレジットがかかります。 サブスクリプションのクレジットは毎月更新され、翌月には繰り越されません。追加購入したクレジットの有効期限は 6 か月です。 get_api_usage ツール（または /usage エンドポイントを直接利用）で使用量を確認してください。最新かつ正式な料金については、 Subscriptions & credits と Credit overview をご覧ください。

設定

サーバーを動作させるには FR24 API キーが必要です。MCP の設定ファイルで設定できます：

{
  "mcpServers": {
    "flightradar24": {
      "command": "node",
      "args": ["/path/to/flightradar24-server/build/index.js"],
      "env": {
        "FR24_API_KEY": "YOUR_FR24_API_KEY_HERE"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

使用例

フライトデータの取得

<use_mcp_tool>
<server_name>flightradar24</server_name>
<tool_name>get_flight_data</tool_name>
<arguments>
{
  "flight_number": "BA123"
}
</arguments>
</use_mcp_tool>

フライトの検索

<use_mcp_tool>
<server_name>flightradar24</server_name>
<tool_name>search_flights</tool_name>
<arguments>
{
  "airline_icao": "BAW",
  "limit": 5
}
</arguments>
</use_mcp_tool>

フライト概要の取得（過去のフライト／完了したフライト）

<use_mcp_tool>
<server_name>flightradar24</server_name>
<tool_name>get_flight_summary</tool_name>
<arguments>
{
  "flight_datetime_from": "2024-01-01T00:00:00Z",
  "flight_datetime_to": "2024-01-02T00:00:00Z",
  "route": "JFK-LAX"
}
</arguments>
</use_mcp_tool>

フライトの航跡の取得

<use_mcp_tool>
<server_name>flightradar24</server_name>
<tool_name>get_flight_tracks</tool_name>
<arguments>
{
  "flight_id": "3b3d2e3f"
}
</arguments>
</use_mcp_tool>

空港データの取得

<use_mcp_tool>
<server_name>flightradar24</server_name>
<tool_name>get_airport_data</tool_name>
<arguments>
{
  "code": "LHR"
}
</arguments>
</use_mcp_tool>

ゾーン内のフライトの取得

<use_mcp_tool>
<server_name>flightradar24</server_name>
<tool_name>get_flights_in_zone</tool_name>
<arguments>
{
  "north": 51.6,
  "south": 51.4,
  "west": -0.5,
  "east": 0.2
}
</arguments>
</use_mcp_tool>

フライトリソースへのアクセス

<access_mcp_resource>
<server_name>flightradar24</server_name>
<uri>flight://BA123</uri>
</access_mcp_resource>

ゾーンリソースへのアクセス

<access_mcp_resource>
<server_name>flightradar24</server_name>
<uri>zone://51.6/51.4/-0.5/0.2</uri>
</access_mcp_resource>

移行に関する注意事項（v1 → v2）

バージョン 2 では、古い未ドキュメント化の api.flightradar24.com/v1 ホストへのすべての呼び出しを、FR24 独自の fr24api-mcp リファレンスサーバーで確認した、正式な FR24 API fr24api.flightradar24.com に置き換えています。これに伴い、環境変数とツールセットの両方が変更されました。

• 環境変数名を変更：FLIGHTRADAR24_API_KEY → FR24_API_KEY。
• search_airports を削除：実際の API が対応しているのは、IATA／ICAO コードによる完全一致の検索（/static/airports/{code}）のみです。名前、国、自由入力による検索は実際には存在しないため、代替機能を装うことはできません。実際に利用可能なこの機能は、get_airport_data で提供されます。
• get_aircraft_data を削除：実際の API には、登録記号から航空機を検索するレジストリがありません（所有者、運航会社、製造元、MSN、機齢のデータは、ドキュメント化された仕様のどこにもありません）。登録記号は引き続き、search_flights、get_flight_summary、およびライブ／履歴位置情報のクエリでフィルターとしてのみ利用できます。静的な航空機の詳細を検索する用途には使用できなくなりました。
• get_flight_summary を追加：実際の API には、旧 API のように予定時刻、推定時刻、実時刻を含む単一の「フライト情報」エンドポイントはありません。ライブ位置情報（get_flight_data 経由）は飛行中のみ取得できます。get_flight_summary は /flight-summary を利用し、完了済みまたは過去のフライトに対応する実際の機能です。
• get_flight_tracks を追加：get_flight_data のレスポンスに含まれていた「trail」フィールドに代わるものです。実際の API では独立したエンドポイント（/flight-tracks）として提供され、フライト番号ではなく FR24 フライト ID（fr24_id）をキーとして使います。
• get_api_usage を追加：実際の API はリクエストごとにクレジットを消費します。このツールは /usage エンドポイントをラップしており、クライアントから利用状況を監視できます（FR24 により1分あたり1回にレート制限されています）。
• 航空会社の検索は ICAO コードのみ：実際の航空会社エンドポイントが受け付けるのは ICAO コードのみで、返すのも { name, iata, icao } のみです。旧ツールとは異なり、IATA コードによる検索や国フィールドには対応していません。
• すべてのツールで Accept-Version: v1 が必要：FR24 API の要件に従い、クライアントがすべてのリクエストで自動的にこのヘッダーを送信します。
• すべてのツールに readOnlyHint: true ／ openWorldHint: true のアノテーションを追加：すべてのツールがサードパーティのデータソースを読み取るだけの機能だからです。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳しくは LICENSE ファイルをご覧ください。