星战科技xingzhan.cloud
返回市场
飞行追踪24API-MCP

飞行追踪24API-MCP

作者：Flightradar247 星标更新：2025-11-12
安装使用来源：spider==github.com

项目介绍

Flightradar24 MCP 服务器

npm 版本 许可证：MIT

此 模型上下文协议 (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

获取带有基本信息的实时飞机位置。

参数（至少需要一个）：

  • bounds：地理区域（北、南、西、东坐标）
  • 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（十六进制）

参考数据

get_airline_info

通过 ICAO 代码获取航空公司信息。

必需参数：

  • icao：航空公司 ICAO 代码

get_airport_info_light

获取基本的机场信息。

必需参数：

  • code：机场 IATA 或 ICAO 代码

get_airport_info_full

获取包括位置、海拔、时区在内的全面机场信息。

必需参数：

  • code：机场 IATA 或 ICAO 代码

使用示例

查找纽约附近的航班

获取纽约地区的实时航班，边界：41.0,-74.5,40.5,-73.5

跟踪特定航班

获取航班ID为 2f4a8b3c 的航班轨迹

历史数据

获取2021年12月31日00:00:00 UTC时JFK机场的历史航班，机场：inbound:JFK

飞行概要

获取从2024-01-01T00:00:00Z到2024-01-02T00:00:00Z期间JFK-LAX航线的飞行概要

开发

从源码构建

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

贡献

  1. 分叉仓库
  2. 创建功能分支
  3. 进行更改
  4. 如适用，添加测试
  5. 提交拉取请求

支持

许可证

MIT 许可证 - 详情见 LICENSE 文件。

更新日志

1.0.1

发布至 MCP 注册表

1.0.0

  • 初始公开发布
  • 全面的飞行数据访问
  • 实时和历史数据支持
  • 增强的参数验证
  • 改进的错误处理