飞行跟踪器MCP服务器
模型上下文协议(MCP)服务器,使用OpenSky Network API提供全面的飞行跟踪功能。
特性
- 实时航班跟踪:获取任何位置头顶飞机的实时飞行数据
- 地理搜索:查询边界框内的航班或半径搜索
- 历史数据:访问特定飞机或机场的飞行历史
- 机场运营:跟踪特定机场的到达和离开情况
- 飞行路线:通过位置历史获取详细的飞行轨迹
- 身份验证支持:增强数据访问的可选身份验证
安装
pip install flight-tracker-mcp用法
基本MCP服务器设置
from flight_tracker_mcp import main
import asyncio
# Run the MCP server
if __name__ == "__main__":
asyncio.run(main())可用工具
1.搭乘高架航班
获取当前特定位置上空的航班:
{
"name": "get_overhead_flights",
"arguments": {
"latitude": 40.7128,
"longitude": -74.0060,
"radius_km": 10
}
}2.让各州进入边界框
查询某一地理区域内的航班:
{
"name": "get_states_in_bbox",
"arguments": {
"min_lat": 40.0,
"max_lat": 41.0,
"min_lon": -75.0,
"max_lon": -73.0
}
}3.获取机场到达信息
跟踪特定机场的到达情况:
{
"name": "get_airport_arrivals",
"arguments": {
"airport": "KJFK",
"start_time": 1640995200,
"end_time": 1641081600
}
}4.获取飞机轨迹
获取特定飞机的飞行路径:
{
"name": "get_aircraft_track",
"arguments": {
"icao24": "a1b2c3",
"timestamp": 0
}
}身份验证(可选)
为了增强数据访问,您可以提供OpenSky Network凭据:
from flight_tracker_mcp import FlightTracker
# With authentication
tracker = FlightTracker(username="your_username", password="your_password")
# Without authentication (limited to public data)
tracker = FlightTracker()MCP集成
此服务器与兼容MCP的客户端(如Claude Desktop)集成。添加到MCP配置中:
{
"mcpServers": {
"flight-tracker": {
"command": "python",
"args": ["-m", "flight_tracker_mcp"]
}
}
}api参考
所有工具返回JSON格式的航班数据,包括以下常见字段:
icao24:飞机标识符callsign:航班呼号latitude/longitude:位置坐标geo_altitude_m:海拔高度(单位:米)velocity_mps:速度(米/秒)heading:真正的轨道航向last_contact:上次位置更新的时间戳
需求
- Python>=3.8
- OpenSky Network API访问(建议免费注册)
- MCP兼容客户端
数据源
此软件包使用 OpenSky网络 API,提供来自全球ADS-B接收机网络的实时和历史飞行数据。
许可证
MIT许可证-有关详细信息,请参阅许可证文件。
贡献
欢迎投稿!请随时提交拉取请求。
支持
如果您遇到任何问题或有疑问,请在GitHub存储库上打开问题。
