Cyreslab AI Flightradar MCP Server

🚀 飛行レーダー MCP サーバー

Model Context Protocol (MCP) をベースにしたサーバーで、AviationStack API を使用してリアルタイムの飛行追跡と状態情報を提供します。

🚀 クイックスタート

飛行レーダー MCP サーバーは、AviationStack API を利用してリアルタイムの飛行追跡と状態情報を提供します。以下の手順でサーバーをセットアップして使用できます。

✨ 主な機能

この MCP サーバーは、3つの主要な機能を提供します。

1. フライトデータの取得：IATA または ICAO コードを使用して、特定のフライトの詳細情報を取得します。
2. フライトの検索：航空会社、出発/到着空港、状態などの複数の基準でフライトを検索します。
3. フライトステータスの取得：特定のフライトについて、理解しやすいステータス概要を生成します。

📦 インストール

Smithery を通じたインストール

Smithery を通じて flightradar - mcp - server を自動的にインストールするには（Claude Desktop 用）：

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 デスクトップアプリケーションの場合、MCP 設定構成に追加します。

💻 使用例

基本的な使用法

フライトデータの取得

IATA または ICAO コードを使用して、特定のフライトの詳細情報を取得します。

GET /api/flight/{iata_or_icao}

リクエストパラメータ

• iata_or_icao：IATA または ICAO コード（例: "LAX" または "KLAX"）

レスポンス例

{
  "data": {
    "flight_number": "AA123",
    "airline": "American Airlines",
    "source_airport": "LAX",
    "destination_airport": "JFK",
    "departure_time": "2024-01-01T10:00:00Z",
    "arrival_time": "2024-01-01T13:00:00Z",
    "status": "on time"
  }
}

フライトの検索

複数の基準でフライトを検索します。

GET /api/search

リクエストパラメータ

• airline：航空会社名（オプション）
• source：出発空港コード（オプション）
• destination：到着空港コード（オプション）
• date：日付（オプション）

レスポンス例

{
  "data": [
    {
      "flight_number": "AA123",
      "airline": "American Airlines",
      "source_airport": "LAX",
      "destination_airport": "JFK",
      "departure_time": "2024-01-01T10:00:00Z",
      "arrival_time": "2024-01-01T13:00:00Z",
      "status": "on time"
    },
    {
      "flight_number": "UA456",
      "airline": "United Airlines",
      "source_airport": "SFO",
      "destination_airport": "ORD",
      "departure_time": "2024-01-01T11:00:00Z",
      "arrival_time": "2024-01-01T14:00:00Z",
      "status": "delayed"
    }
  ]
}

フライトステータスの取得

特定のフライトについて、理解しやすいステータス概要を生成します。

GET /api/status/{iata_or_icao}

リクエストパラメータ

• iata_or_icao：IATA または ICAO コード（例: "LAX" または "KLAX"）

レスポンス例

{
  "data": {
    "flight_number": "AA123",
    "airline": "American Airlines",
    "source_airport": "LAX",
    "destination_airport": "JFK",
    "departure_time": "2024-01-01T10:00:00Z",
    "arrival_time": "2024-01-01T13:00:00Z",
    "status": "on time"
  }
}

📚 ドキュメント

API キーの構成

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

API キーは、MCP 設定構成で環境変数 AVIATIONSTACK_API_KEY として提供する必要があります。

📄 ライセンス

MIT