fr24api-mcp

Flightradar24 MCP 服务

此 Model Context Protocol (MCP) 服务提供对 Flightradar24 API 的访问，可获取实时和历史航班数据。此服务让 Claude 等 AI 助手能够访问全面的航空数据，包括实时航班位置、飞机信息、机场详情和航班历史记录。

功能

• 实时航班追踪：获取全球飞机的实时位置
• 历史航班数据：访问可追溯至 2016 年 5 月 11 日的航班数据
• 全面的航班信息：详细的飞机、航空公司和机场数据
• 灵活筛选：按呼号、注册号、航线、飞机类型等搜索
• 航班摘要：完整的起飞和降落信息
• 飞机轨迹：特定航班的详细位置追踪

安装

通过 npm

npm install -g @flightradar24/fr24api-mcp

前提条件

1. Node.js：版本 18.0.0 或更高
2. Flightradar24 API Key：从 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 代码

使用示例

查找纽约周边的航班

Get live flights in the New York area with bounds: 41.0,-74.5,40.5,-73.5

跟踪特定航班

Get flight tracks for flight ID: 2f4a8b3c

历史数据

Get historical flights at JFK airport on timestamp 1640995200 with airports: inbound:JFK

航班摘要

Get flight summary from 2024-01-01T00:00:00Z to 2024-01-02T00:00:00Z for route JFK-LAX

开发

从源代码构建

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

贡献

1. Fork 此仓库
2. 创建功能分支
3. 完成更改
4. 视情况添加测试
5. 提交 pull request

支持

• 文档：https://fr24api.flightradar24.com
• 问题：GitHub Issues
• API 支持：联系 Flightradar24 API 支持团队

许可证

MIT 许可证——详情请参阅 LICENSE 文件。

更新日志

1.0.2

• 修复：航班摘要 14 天提示词
• 更新发布文件，确保受信任发布者正常工作（#6）

1.0.1

发布到 MCP Registry

1.0.0

• 首次公开发布
• 全面的航班数据访问
• 支持实时和历史数据
• 增强参数验证
• 改进错误处理