fr24api-mcp

Flightradar24 MCP サーバー

この Model Context Protocol (MCP) サーバーは、リアルタイムおよび履歴のフライトデータにアクセスするための Flightradar24 API へのアクセスを提供します。このサーバーにより、Claude のような AI アシスタントが、リアルタイムの航空機位置、機体情報、空港の詳細、フライト履歴を含む包括的な航空データにアクセスできるようになります。

機能

• リアルタイムのフライト追跡: 世界中の航空機のライブ位置を取得
• 履歴フライトデータ: 2016年5月11日にさかのぼるフライトデータにアクセス
• 包括的なフライト情報: 機体、航空会社、空港の詳細データ
• 柔軟なフィルタリング: コールサイン、登録記号、ルート、機種などで検索
• フライトサマリー: 完全な離陸および着陸情報
• 航空機のトラック: 特定のフライトの詳細な位置追跡

インストール

npm 経由

npm install -g @flightradar24/fr24api-mcp

前提条件

1. Node.js: バージョン 18.0.0 以上
2. Flightradar24 API キー: https://fr24api.flightradar24.com から API キーを取得してください

設定

Claude Desktop との統合

この設定を claude_desktop_config.json ファイルに追加してください:

{
  "mcpServers": {
    "fr24api": {
      "command": "npx",
      "args": ["@flightradar24/fr24api-mcp@latest"],
      "env": {
        "FR24_API_KEY": "your_api_key_here"
      }
    }
  }
}

重要な注意事項:

• your_api_key_here を実際の Flightradar24 API キーに置き換えてください
• 設定を追加した後、Claude Desktop を再起動してください
• ローカルにインストールした場合は、フルパスを使用してください: "command": "node", "args": ["/path/to/build/index.js"]

その他の MCP クライアント

その他の MCP クライアントでは、サーバーを直接実行してください:

FR24_API_KEY=your_api_key_here npx @flightradar24/fr24api-mcp

利用可能なツール

ライブフライトデータ

get_live_flights_positions_light

基本的な情報を含むリアルタイムの航空機位置を取得します。

パラメータ (少なくとも1つが必要):

• bounds: 地理的な範囲 (north,south,west,east 座標)
• flights: フライト番号 (カンマ区切り、最大15)
• callsigns: フライトのコールサイン (カンマ区切り、最大15)
• registrations: 航空機の登録記号 (カンマ区切り、最大15)
• airports: 空港コードと任意の方向 (例: "inbound:JFK,outbound:LAX")
• routes: フライトルート (例: "JFK-LAX,LHR-CDG")
• aircraft: 航空機の ICAO 型式 (カンマ区切り、最大15)
• altitude_ranges: フィート単位の高度範囲 (例: "0-3000,30000-40000")
• categories: フライトカテゴリ (P,C,M,J,T,H,B,G,D,V,O,N)
• limit: 最大結果数 (デフォルト: 制限なし、最大: 30000)

get_live_flights_positions_full

包括的なフライト詳細を含むリアルタイムの航空機位置を取得します。 上記と同じパラメータ

get_live_flights_count

条件に一致するライブフライトの件数を取得します。 上記と同じパラメータ

履歴フライトデータ

get_historic_flights_positions_full

完全な詳細を含む履歴のフライト位置を取得します。

必須パラメータ:

• timestamp: 履歴スナップショット用の Unix タイムスタンプ

任意パラメータ: ライブフライトのパラメータと同じ

get_historic_flights_positions_light

基本的な情報を含む履歴のフライト位置を取得します。 上記と同じパラメータ

get_historic_flights_count

履歴フライトの件数を取得します。 上記と同じパラメータ

フライトサマリー

get_flight_summary_full

包括的なフライトの離陸・着陸情報を取得します。

必須パラメータ:

• flight_datetime_from: 開始日時 (YYYY-MM-DDTHH:MM:SSZ)
• flight_datetime_to: 終了日時 (YYYY-MM-DDTHH:MM:SSZ)

任意パラメータ:

• flights、callsigns、registrations、airports、routes、aircraft
• sort: 並び順 ("asc" または "desc")
• limit: 最大結果数 (最大: 20000)

get_flight_summary_light

必須のフライト離着陸情報を取得します。 上記と同じパラメータ

get_flight_summary_count

サマリークエリ内のフライトの件数を取得します。 上記と同じパラメータ (sort/limit を除く)

特定のフライトデータ

get_flight_tracks

特定のフライトの詳細な位置トラックを取得します。

必須パラメーター:

• flight_id: Flightradar24 フライト ID（16 進数）

参照データ

get_airline_info

ICAO コードで航空会社情報を取得します。

必須パラメーター:

• icao: 航空会社の ICAO コード

get_airport_info_light

基本的な空港情報を取得します。

必須パラメーター:

• code: 空港の IATA または ICAO コード

get_airport_info_full

所在地、標高、タイムゾーンを含む包括的な空港情報を取得します。

必須パラメーター:

• code: 空港の IATA または ICAO コード

使用例

ニューヨーク周辺のフライトを検索する

Get live flights in the New York area with bounds: 41.0,-74.5,40.5,-73.5

特定のフライトを追跡する

Get flight tracks for flight ID: 2f4a8b3c

履歴データ

Get historical flights at JFK airport on timestamp 1640995200 with airports: inbound:JFK

フライト概要

Get flight summary from 2024-01-01T00:00:00Z to 2024-01-02T00:00:00Z for route JFK-LAX

開発

ソースからのビルド

git clone https://github.com/flightradar24/fr24api-mcp.git
cd fr24api-mcp
npm install
npm run build

コントリビューション

1. リポジトリをフォークします
2. フィーチャーブランチを作成します
3. 変更を加えます
4. 必要に応じてテストを追加します
5. プルリクエストを送信します

サポート

• ドキュメント: https://fr24api.flightradar24.com
• Issues: GitHub Issues
• API サポート: Flightradar24 API サポートにお問い合わせください

ライセンス

MIT License - 詳細は LICENSE ファイルをご覧ください。

変更履歴

1.0.2

• fix: flight summary 14 days prompt
• release file update to asure trusted publisher works (#6)

1.0.1

MCP Registry へリリース

1.0.0

• 初回一般公開リリース
• 包括的なフライトデータアクセス
• リアルタイムおよび履歴データのサポート
• パラメーター検証の強化
• エラー処理の改善