Flightradar24 MCP Server

Flightradar24 MCP 服务

一个模型上下文协议（MCP）服务，可访问来自 Flightradar24 官方商业 API（fr24api.flightradar24.com）的航班追踪数据。

此服务此前调用的是未经文档说明、通过逆向工程获得的移动应用端点 （api.flightradar24.com/v1/...）。现已迁移至 FR24 正式、提供文档且按调用量计费的 API。变更内容请参阅下方的“迁移说明”。

功能

工具

• get_flight_data：通过航班号或呼号，获取特定当前正在飞行的航班的实时位置数据
• search_flights：按航空公司、注册号、机型、航线、高度或地理区域，搜索当前正在飞行的航班
• get_flight_summary：获取指定日期/时间范围内已完成航班的起飞/降落历史记录
• get_flight_tracks：通过 FR24 航班 ID，获取某一航班的详细位置轨迹
• get_airport_data：通过机场准确的 IATA 或 ICAO 代码获取机场信息
• get_airline_data：通过航空公司的 ICAO 代码获取其名称和 IATA 代码
• get_flights_in_zone：获取指定地理边界框内所有当前正在飞行的航班
• get_api_usage：获取各端点的 FR24 API 额度使用情况汇总

资源

• flight://{flight_number}：通过 IATA 或 ICAO 航班号获取当前正在飞行航班的实时位置
• airport://{code}：通过准确的 IATA 或 ICAO 代码获取机场信息
• airline://{icao}：通过 ICAO 代码获取航空公司信息
• flighttrack://{flight_id}：通过 FR24 航班 ID 获取特定航班的详细位置轨迹
• zone://{north}/{south}/{west}/{east}：获取指定地理区域内当前正在飞行的航班

安装

1. 克隆此仓库
2. 安装依赖项：

   npm install
   

3. 构建服务：

   npm run build
   

获取 FR24 API 密钥

1. 在 fr24api.flightradar24.com 创建账户并订阅 API 套餐。
2. 在密钥管理页面生成令牌。
3. 将其设为 FR24_API_KEY 环境变量（参见下方的配置）。

定价 / 额度简介

FR24 API 按额度计费，并非固定费率订阅：每次请求消耗的额度取决于返回的实体（航班、机场等）数量，且每个实体的费用因端点而异。 例如，Live Flight Positions（light）查询每返回一个航班约消耗 6 个额度。 订阅额度每月刷新且不会结转；充值额度在 6 个月后过期。 请使用 get_api_usage 工具（或直接调用 /usage 端点）监控用量，并参阅 订阅与额度和 额度概览，了解当前权威定价。

配置

服务需要 FR24 API 密钥才能运行。你可以在 MCP 设置配置文件中设置密钥：

{
  "mcpServers": {
    "flightradar24": {
      "command": "node",
      "args": ["/path/to/flightradar24-server/build/index.js"],
      "env": {
        "FR24_API_KEY": "YOUR_FR24_API_KEY_HERE"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

使用示例

获取航班数据

<use_mcp_tool>
<server_name>flightradar24</server_name>
<tool_name>get_flight_data</tool_name>
<arguments>
{
  "flight_number": "BA123"
}
</arguments>
</use_mcp_tool>

搜索航班

<use_mcp_tool>
<server_name>flightradar24</server_name>
<tool_name>search_flights</tool_name>
<arguments>
{
  "airline_icao": "BAW",
  "limit": 5
}
</arguments>
</use_mcp_tool>

获取航班摘要（历史 / 已完成的航班）

<use_mcp_tool>
<server_name>flightradar24</server_name>
<tool_name>get_flight_summary</tool_name>
<arguments>
{
  "flight_datetime_from": "2024-01-01T00:00:00Z",
  "flight_datetime_to": "2024-01-02T00:00:00Z",
  "route": "JFK-LAX"
}
</arguments>
</use_mcp_tool>

获取航班轨迹

<use_mcp_tool>
<server_name>flightradar24</server_name>
<tool_name>get_flight_tracks</tool_name>
<arguments>
{
  "flight_id": "3b3d2e3f"
}
</arguments>
</use_mcp_tool>

获取机场数据

<use_mcp_tool>
<server_name>flightradar24</server_name>
<tool_name>get_airport_data</tool_name>
<arguments>
{
  "code": "LHR"
}
</arguments>
</use_mcp_tool>

获取区域内的航班

<use_mcp_tool>
<server_name>flightradar24</server_name>
<tool_name>get_flights_in_zone</tool_name>
<arguments>
{
  "north": 51.6,
  "south": 51.4,
  "west": -0.5,
  "east": 0.2
}
</arguments>
</use_mcp_tool>

访问航班资源

<access_mcp_resource>
<server_name>flightradar24</server_name>
<uri>flight://BA123</uri>
</access_mcp_resource>

访问区域资源

<access_mcp_resource>
<server_name>flightradar24</server_name>
<uri>zone://51.6/51.4/-0.5/0.2</uri>
</access_mcp_resource>

迁移说明（v1 → v2）

版本 2 将所有对旧版、未公开文档的 api.flightradar24.com/v1 主机的调用，替换为 FR24 真正的官方 API：fr24api.flightradar24.com。这一点已根据 FR24 自家的 fr24api-mcp 参考服务确认。环境变量和工具集也因此发生了变化：

• 环境变量已重命名：FLIGHTRADAR24_API_KEY → FR24_API_KEY。
• 已移除 search_airports：真正的 API 只支持按 IATA/ICAO 代码精确查询（/static/airports/{code}）——没有名称、国家/地区或自由文本搜索功能，无法伪造。现在由 get_airport_data 覆盖这项真实功能。
• 已移除 get_aircraft_data：真正的 API 完全没有按注册号查询的飞机注册信息库（其文档化的 API 契约中没有所有者、运营方、制造商、MSN 或机龄数据）。注册号仍可作为 search_flights、get_flight_summary 以及实时/历史位置查询的筛选条件，但无法再用于查询飞机静态详情。
• 新增 get_flight_summary：真正的 API 没有旧版提供的、包含计划、预计和实际时间的单一“航班信息”端点。实时位置数据（通过 get_flight_data 获取）仅在航班飞行期间存在；基于 /flight-summary 的 get_flight_summary 是查询已完成/历史航班的真实替代方案。
• 新增 get_flight_tracks：用于替代过去嵌入在 get_flight_data 响应中的“trail”字段。真正的 API 将其作为独立端点（/flight-tracks）提供，并通过 FR24 航班 ID（fr24_id）而非航班号作为索引。
• 新增 get_api_usage：真正的 API 按请求计量额度；此工具封装了其 /usage 端点（FR24 将其限速为每分钟 1 次调用），因此客户端可以监控用量。
• 航空公司查询仅支持 ICAO 代码：真正的航空公司端点只接受 ICAO 代码，并且只返回 { name, iata, icao }——与旧工具不同，它不支持按 IATA 代码查询，也不返回国家/地区字段。
• 所有工具都要求 Accept-Version: v1：根据 FR24 API 的要求，客户端会在每个请求中自动发送此标头。
• 所有工具现在都带有 readOnlyHint: true / openWorldHint: true 注解，因为它们都是对第三方数据源进行的纯读取操作。

许可证

本项目采用 MIT 许可证授权——详情请参阅 LICENSE 文件。