Aviation MCP

🚀 航空天気 MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）に基づいており、飛行計画に必要な航空天気情報を提供します。航空天気 API に接続して、METAR、TAF、PIREPs などのデータを取得します。

🚀 クイックスタート

この航空天気 MCP サーバーを使用することで、飛行計画に必要な天気情報を取得できます。ただし、本ツールは参考用であり、飛行計画や飛行中の意思決定に使用しないでください。

✨ 主な機能

• 型安全な 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

⚠️ 重要提示

このツールを飛行計画や飛行中の意思決定に使用しないでください！本航空天気 MCP サーバーが提供する天気データは aviationweather.gov から取得され、参考用にのみ提供されます。飛行計画や飛行中の意思決定にこのツールのみに依存しないでください。

天気データには不備、遅延、または不正確な場合があります。さらに、これらのデータを解釈する大規模言語モデルは、重要な情報を誤解または誤って表現する可能性があります。すべての飛行前に、常に公式の航空天気情報源を参照し、権限のある機関から提供される完全な天気ブリーフィングを取得してください。

このツールは FAA によって承認されておらず、認定された天気サービスの代替品ではありません。参考としてのみ使用してください。開発者は、このツールの情報に基づいて行われた決定に対して一切の責任を負いません。

常に公式チャネルを通じて重要な天気情報を検証してください。