Cyreslab AI Flightradar MCP Server

🚀 飛行雷達 MCP 服務器

飛行雷達 MCP 服務器基於 Model Context Protocol (MCP)，藉助 AviationStack API 提供即時飛行跟蹤和狀態信息，讓你輕鬆掌握航班動態。

🚀 快速開始

本服務器可幫助你獲取航班數據、搜索航班以及獲取航班狀態，為你的航班查詢提供便利。

✨ 主要特性

此 MCP 服務器提供三個主要功能：

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 密鑰才能運行。您可以免費獲取一個密鑰（每月 100 次請求）在 aviationstack.com。 API 密鑰應在 MCP 設置配置中作為環境變量提供，名為 AVIATIONSTACK_API_KEY。

📄 許可證

本項目採用 MIT 許可證。