🚀 航空天气 MCP 服务器

这是一个基于模型上下文协议（MCP）的服务器，主要为飞行规划提供航空天气信息。它会连接到航空天气 API，获取 METAR、TAF、PIREPs 等各类数据，为飞行规划提供有力的数据支持。

🚀 快速开始

本服务器为飞行规划提供航空天气信息，连接航空天气 API 获取多种数据。不过，使用前请务必仔细阅读免责声明。

⚠️ 免责声明

⚠️ 重要提示

请勿将此工具用于飞行计划或飞行中决策！本航空天气 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

💻 使用示例

基础用法

获取当前气象观测

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

与 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"
  }
}

🔧 技术细节

项目结构

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 许可证。