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 许可证。