航空MCP：航空数据的模型上下文协议服务器

航空MCP提供了一系列映射到FAA和其他航空API的模型上下文协议（MCP）服务器，使得将实时航空数据集成到您的LLM驱动的工作流程中变得容易。此项目专为希望将其LLM客户端（如Cursor、Claude或其他）连接到权威的航空数据源（包括天气、NOTAM、图表、飞机信息等）的开发者设计。

⚠️ 免责声明 ⚠️

此代码的开发者不对提供的API的数据正确性或安全性负责，也不对您的特定飞行计划的安全性负责。这适用于软件以及FlightPlanning.md中的指令，它们不能替代适当执照飞行员的专业知识。机长独自负责飞行安全并遵守所有相关法规。

功能

• 模块化的航空数据MCP服务器
• 集成FAA、航空天气和其他API
• 易于配置，适用于任何兼容MCP的LLM客户端
• 作为npm包发布：aviation-mcp

使用MCP服务器

在您的mcp.json中添加aviation-mcp服务器如下所示。确保更新密钥以包含有效值（访问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>"
         }
      }
   }
}

官方来源

• weather：航空天气数据（METAR、TAF、PIREP、SIGMET、G-AIRMET等）
• charts：分区图、TAC、IFR航路图和TPP图
• notam：FAA NOTAM API

🚧 故障来源 🚧

这些来源可能会有所帮助，但集成或API访问尚未工作：

• precipitation：FAA EIM天气临近API（降水数据）
• airports：FAA机场和跑道信息

尚未实现

• delays：ASWS FAA API提供有关机场延误的信息。

🚧🚧 非官方来源 🚧🚧

• aircraft：飞机数据

🚧 缺失来源 🚧

• 机器可读格式的过程路线。TODO：下载CIFP数据，并使用类似arinc424的东西将其转换为可用格式。
• 机器可读格式的空域数据。TODO：下载NASR数据，并使用库来读取shapefile和/或AIXM数据。

使用方法

配置完成后，您的LLM客户端可以连接到MCP服务器并按需查询航空数据。详情请参阅您客户端的文档，了解如何提供mcp.json配置。

参见FlightPlanning.md，获取用于飞行规划的样本系统提示。

为了时间感知，建议结合time。

对于EFB管理，考虑结合filesystem或gdrive。

API覆盖

要查看支持的API、端点及其集成状态的详细列表，请参阅Sources.md。

许可证

MIT </中文翻译>