Aviation MCP

🚀 航空天氣 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 許可證。