航空天气 MCP 服务器

这是一个基于模型上下文协议（MCP）的服务器，为飞行规划提供航空天气信息。它连接到航空天气 API 以获取 METAR、TAF、PIREPs 和其他数据。

免责声明

请勿将此工具用于飞行计划或飞行中决策！

重要免责声明： 本航空天气 MCP 服务器提供的天气数据来自 aviationweather.gov，仅供参考。绝不能仅依赖此工具进行飞行计划或飞行中决策。

天气数据可能存在不完整、延迟或不准确的情况。此外，解释这些数据的大语言模型可能会误解或错误表示关键信息。在任何飞行前，请始终咨询官方航空天气来源并获得授权机构提供的完整天气简报。

本工具未经 FAA 批准，不是认证天气服务的替代品，仅作为参考使用。开发者不对基于此工具信息做出的决策承担任何责任。

请始终通过官方渠道验证关键天气信息。

功能

• 类型安全的 API 客户端：从官方航空天气 API 的 Swagger 定义自动生成
• MCP 工具用于获取天气数据：
  • get-metar：获取当前气象观测
  • get-taf：获取终端预报
  • get-pireps：获取机场附近的飞行员报告
  • get-route-weather：获取航线的全面天气信息

安装指南

先决条件

• Node.js 18 或更高版本
• npm 或 yarn
• curl（用于获取 Swagger YAML）

安装步骤

1. 克隆此仓库：

   git clone https://github.com/yourusername/aviation-weather-mcp-server.git
   cd aviation-weather-mcp-server
   

2. 安装依赖项：

   npm install
   

3. 构建服务器（此步骤会获取最新 Swagger 定义、生成 API 客户端并编译 TypeScript）：

   npm run build
   

4. 启动服务器：

   npm start
   

与 Claude for Desktop 集成

要将此服务器与 Claude for Desktop 一起使用：

1. 编辑你的 Claude for Desktop 配置文件：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json`

2. 添加以下内容到配置文件中：

   {
     " aviationWeatherMCP": {
       " serverUrl": "http://localhost:3000"
     }
   }
   

使用说明

获取当前气象观测

npm run get-metar -- --airport=KJFK

获取终端预报

npm run get-taf -- --airport=KLAX

获取飞行员报告

npm run get-pireps -- --region=NE

获取航线天气

npm run get-route-weather -- --origin=KJFK --destination=KLAX

开发信息

项目结构

src/
├── server.ts         # 主服务器文件
├── weather_api.ts   # 天气 API 客户端
└── response_formatter.ts # 响应格式化工具

构建过程

1. 获取 Swagger 定义：

   npm run get-swagger-def -- --url= https://api.aviationweather.com/v2
   

2. 生成 API 客户端：

   npm run generate-client -- --input=./swagger.json
   

许可证

MIT