Flightradar24 MCP 服务器
这个 示范背景协议(MCP) 服务器为实时和历史飞行数据提供访问Flightradar24 API的机会. 这个服务器使克劳德等AI助手能够访问全面的航空数据,包括活机位置,飞机信息,机场细节和飞行历史.
特征
- 实时飞行跟踪:获得全世界飞机的现场位置
- 历史飞行数据:可追溯至2016年5月11日的访问飞行数据
- 综合飞行信息:详细飞机、航空公司和机场数据
- 弹性过滤:按呼号、登记号、路线、飞机类型等进行搜索
- 飞行摘要: 完整的起飞和着陆信息
- 飞机跟踪: 具体飞行的详细位置跟踪
安装
通过 npm
npm install -g @flightradar24/fr24api-mcp
先决条件
- 节点.js: 18.0.0或更高版本
- Flightradar24 API 键: 从 https://fr24api.flightradar24.com (中文(简体) )
配置
克劳德桌面集成
将此配置添加到您的 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 桌面
- 如果在本地安装, 请使用完整路径 :
"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:有可选方向的机场代码(例如"入境:JFK,出境:LAX")routes:飞行路线(如"JFK-LAX,LHR-CDG")aircraftICAO型号(分列,最多15架)altitude_ranges:海拔范围为足(如"0-3000,3300-40000")categories:飞行类别(P、C、M、J、T、H、B、G、D、V、O、N)limit: 最大结果( 默认: 无限制, 最大: 3000)
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:开始日期(YYY-MM-DDTH:MM:SSZ)flight_datetime_to:结束日期(YYY-MM-DDTH:MM:SSZ)
可选参数:
flights, (中文(简体) ),callsigns, (中文(简体) ),registrations, (中文(简体) ),airports, (中文(简体) ),routes, (中文(简体) ),aircraftsort:排序顺序("asc"或"desc")limit: 最大结果(最大:2000)
get_flight_summary_light
获取必要的飞行起飞/着陆信息. 与上述参数相同
get_flight_summary_count
在汇总查询中获取航班数 . 参数与以上相同(无排序/限制)
特定飞行数据
get_flight_tracks
获取具体飞行的详细位置轨迹.
所需参数:
flight_id: Flightradar24 飞行编号(十六进制)
参考数据
get_airline_info
按ICAO代码获取航空公司信息.
所需参数:
icao: 国际民航组织航空公司代码
get_airport_info_light
获取机场基本信息.
所需参数:
code: 机场空运协会或民航组织代码
get_airport_info_full
获得全面的机场信息,包括位置,高地,时区.
所需参数:
code: 机场空运协会或民航组织代码
用法实例
在纽约附近寻找航班
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
捐款
- 叉子存储器
- 创建特性分支
- 做你的改变
- 在适用的情况下添加测试
- 提交拉动请求
支助
- 文档数字 : https://fr24api.flightradar24.com (中文(简体) )
- 问题数字 : GitHub 问题
- API 支持: 联系 Flightradar24 API 支持
许可证
麻省理工学院执照 - 看 自由主义 详细文件.
更改日志
1.0.2 联合国
- 14天即时飞行
- 向 asure 信任的出版者作品发布文件更新 (# 6)
1.0.1 (中文(简体) )
释放到 MCP 书记官处
1.0.0 (单位:千美元)
- 初次公开释放
- 全面飞行数据存取
- 实时和历史数据支助
- 增强参数验证
- 改进了错误处理