Fr24api MCP

Flightradar24 MCP服务器

这 模型上下文协议（MCP） 服务器提供对Flightradar24 API的实时和历史飞行数据访问。该服务器使像克劳德这样的人工智能助手能够访问全面的航空数据，包括实时航班位置、飞机信息、机场详细信息和飞行历史。

原始项目：该项目基于官方Flightradar24 MCP服务器。\ 原始存储库：

特性

• 实时航班跟踪：获取全球飞机的实时位置
• 历史飞行数据：访问可追溯到2016年5月11日的航班数据
• 综合航班信息：详细的飞机、航空公司和机场数据
• 灵活过滤：按呼号、注册、路线、飞机类型等搜索
• 航班概要：完整的起飞和着陆信息
• 飞机航迹：特定航班的详细位置跟踪

安装

通过npm

npm install -g @bachstudio/fr24api-mcp

先决条件

1. Node.js：18.0.0或更高版本
2. Flightradar24 API密钥：从获取API密钥 https://fr24api.flightradar24.com

配置

Claude桌面集成

将此配置添加到您的 claude_desktop_config.json 文件：

{
  "mcpServers": {
    "fr24api": {
      "command": "npx",
      "args": ["@bachstudio/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 @bachstudio/fr24api-mcp

可用工具

实时飞行数据

get_live_flights_positions_light

获取实时飞机位置和基本信息。

参数 （至少需要一个）：

• bounds地理区域（北、南、西、东坐标）
• flights：航班号（逗号分隔，最多15个）
• callsigns：航班呼号（逗号分隔，最多15个）
• registrations：飞机登记（逗号分隔，最多15个）
• airports：带有可选方向的机场代码（例如，“入境：肯尼迪国际机场，出境：洛杉矶国际机场”）
• routes：飞行路线（例如，“JFK-LAX、LHR-CDG”）
• aircraft：国际民航组织飞机类型（逗号分隔，最多15种）
• altitude_ranges：高度范围（单位：英尺）（例如，“0-300030000-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-DTHH:MM:SSZ）
• flight_datetime_to：结束日期时间（YYYY-MM-DTHH:MM:SSZ）

可选参数：

• flights, callsigns, registrations, airports, routes, aircraft
• sort：排序顺序（“asc”或“desc”）
• limit：最大结果（最大值：20000）

get_flight_summary_light

获取重要的航班起飞/降落信息。 *与上述参数相同*

get_flight_summary_count

在汇总查询中获取航班计数。 *与上述参数相同（无排序/限制）*

具体飞行数据

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/BACH-AI-Tools/fr24api-mcp.git
cd fr24api-mcp
npm install
npm run build

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 如果适用，添加测试
5. 提交拉取请求

支持

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

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

更新日志

1.0.1

释放到 MCP注册表

1.0.0

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