使用说明
航空MCP:航空数据模型上下文协议服务器
航空MCP提供了一套模型上下文协议(MCP)服务器,这些服务器映射到FAA和其他航空API,使您可以轻松地将实时航空数据集成到LLM驱动的工作流程中。该项目专为希望将其LLM客户(如Cursor、Claude或其他人)连接到权威航空数据源以获取天气、NOTAM、图表、飞机信息等的开发人员而设计。
⚠️ 免责声明⚠️
此代码的开发人员是 不负责任 以确保提供数据的API的正确性或安全性,或您特定航班的飞行计划。这适用于软件和中的说明 飞行计划.md,其中 不要取代持有适当执照的飞行员的专业知识机长全权负责飞行安全和遵守所有相关规定。
特性
- 用于航空数据的模块化MCP服务器
- 与美国联邦航空局、航空气象和其他API集成
- 易于配置,可与任何兼容MCP的LLM客户端一起使用
- 发布为npm包:
aviation-mcp
使用MCP服务器
将航空mcp服务器添加到您的mcp.json中,如下所示。确保更新密钥以包含有效值(访问https://api.faa.gov/s/对于FAA API客户信用,https://api-ninjas.com/用于其API密钥)或移除它们(并且相关API将被隐藏)。
航空天气(包括大量地理参考数据)和图表不需要任何API密钥。NOTAM需要FAA客户id/机密。
{
"mcpServers": {
"aviation": {
"command": "npx",
"args": [
"-y",
"aviation-mcp"
],
"env": {
"API_NINJA_KEY": "<your-key>",
"FAA_CLIENT_ID": "<your-id>",
"FAA_CLIENT_SECRET": "<your-secret>"
}
}
}
}
官方消息人士
- 天气:航空气象数据(METAR、TAF、PIREP、SIGMET、G-AIRMET等)
- 图表:分段图、TAC图、IFR航路图和TPP图
- 备注:FAA航行通告API
🚧 破碎的来源🚧
这些来源可能会有所帮助,但集成或API访问还不起作用:
- 降水:FAA EIM天气接近API(降水数据)
- 机场:FAA机场和跑道信息
未实现
- 延迟:ASWS FAA API提供有关机场延误的信息。
🚧🚧 非官方消息来源🚧🚧
- 飞机:飞机数据
🚧 缺少来源🚧
- 程序以机器可读格式路由。TODO:下载CIFP数据并使用类似 arinc424 将其转换为可用格式。
- 机器可读格式的空域数据。TODO:下载NASR数据并使用库读取shapefiles和/或AIXM数据。
用法
配置后,您的LLM客户端可以连接到MCP服务器,并根据需要查询航空数据。有关提供 mcp.json 配置。
看 飞行计划.md 用于飞行计划的示例系统提示。
对于时间意识,我建议结合 时间.
API覆盖范围
有关支持的API、端点和集成状态的详细列表,请参阅 Sources.md.
许可证
麻省理工学院