Flightradar24 MCP服务器
](https://badge.fury.io/js/@bachstudio%2Ffr24api-mcp) 
这 模型上下文协议（MCP） 服务器提供对Flightradar24 API的实时和历史飞行数据访问。该服务器使像克劳德这样的人工智能助手能够访问全面的航空数据，包括实时航班位置、飞机信息、机场详细信息和飞行历史。
原始项目：该项目基于官方Flightradar24 MCP服务器。\ 原始存储库：
特性
- 实时航班跟踪：获取全球飞机的实时位置
- 历史飞行数据：访问可追溯到2016年5月11日的航班数据
- 综合航班信息：详细的飞机、航空公司和机场数据
- 灵活过滤：按呼号、注册、路线、飞机类型等搜索
- 航班概要：完整的起飞和着陆信息
- 飞机航迹：特定航班的详细位置跟踪
安装
通过npm
npm install -g @bachstudio/fr24api-mcp先决条件
- Node.js：18.0.0或更高版本
- 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,aircraftsort：排序顺序（“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贡献
- 分叉存储库
- 创建要素分支
- 进行更改
- 如果适用，添加测试
- 提交拉取请求
支持
- 文档: https://fr24api.flightradar24.com
- 问题:
- API支持：联系Flightradar24 API支持
许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
更新日志
1.0.1
释放到 MCP注册表
1.0.0
- 首次公开发布
- 全面的飞行数据访问
- 实时和历史数据支持
- 增强的参数验证
- 改进了错误处理