Aviation Weather MCP Server

Aviation Weather MCP Server

これは、フライトプランニング向けに航空気象情報を提供する Model Context Protocol（MCP）サーバーです。Aviation Weather API に接続し、METAR、TAF、PIREP などのデータを取得します。

免責事項

フライトプランニングや飛行中の意思決定にこのツールを使用しないでください。

重要な免責事項： この Aviation Weather MCP サーバーは、情報提供のみを目的として、aviationweather.gov から取得した気象データを提供します。このツールが提供する情報を、フライトプランニングや飛行中の意思決定における唯一の情報源として使用することは、絶対に避けてください。

気象データは不完全、遅延、または不正確な場合があります。また、このデータを解釈する大規模言語モデルが、重要な情報を誤解したり、誤って表現したりする可能性があります。飛行前には必ず、公式の航空気象情報源を参照し、認定されたプロバイダーから適切な気象ブリーフィングを受けてください。

このツールは FAA の承認を受けておらず、認定された気象サービスの代替にはなりません。補助的な参考情報としてのみ使用してください。開発者は、このツールが提供する情報に基づいて行われた判断について、一切の責任を負いません。

重要な気象情報は、必ず公式の経路を通じて確認してください。

機能

• 公式 Aviation Weather API の Swagger 定義から自動生成された、型安全な API クライアント
• 気象データ用 MCP ツール：
  • get-metar：現在の気象観測を取得します
  • get-taf：飛行場予報を取得します
  • get-pireps：空港付近のパイロットレポートを取得します
  • get-route-weather：2 つの空港間のルートについて、総合的な気象情報を取得します

セットアップ

前提条件

• 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. サーバーを設定に追加します：

   {
     "mcpServers": {
       "aviation-weather": {
         "command": "node",
         "args": [
           "/absolute/path/to/aviation-weather-mcp-server/build/index.js"
         ]
       }
     }
   }
   

3. Claude for Desktop を再起動します

質問の例

Claude に接続したら、次のような質問をできます：

• 「KJFK の現在の天気はどうですか？」
• 「KORD の TAF はありますか？」
• 「明日、KBOS から KPHL まで飛行する予定です。天気はどうなりそうですか？」
• 「KDEN 付近に PIREP はありますか？」

開発

プロジェクト構成

• src/index.ts：メインのサーバーコード
• packages/aviation-weath-api：Aviation Weather .gov 用の API クライアントを自動生成します

aviation weather クライアントのビルド

ビルドプロセスは次の手順で行います：

1. npm run aviation-weather-api:clean：既存のクライアントを削除します
2. npm run aviation-weather-api:fetch：aviationweather.gov から最新の Swagger 定義を取得します
3. npm run aviation-weather-api:generate：Swagger 定義から型付き TypeScript クライアントを生成します

アプリのビルドと実行

1. npm run build：JavaScript クライアントをビルドします
2. npm run start：MCP サーバーを実行します

ツールの追加

サーバーに新しいツールを追加するには、次のパターンに従います：

server.tool(
  "tool-name",
  {
    // Zod schema for parameters
    param1: z.string().describe("Parameter description"),
    param2: z.number().optional().describe("Optional parameter")
  },
  async ({ param1, param2 }) => {
    try {
      // Implementation
      return {
        content: [{
          type: "text",
          text: "Response text"
        }]
      };
    } catch (error) {
      return {
        content: [{
          type: "text",
          text: `Error: ${error.message}`
        }],
        isError: true
      };
    }
  }
);

仕組み

1. サーバーは aviationweather.gov から最新の Swagger 定義を取得します
2. OpenAPI Generator がこの定義から型安全なクライアントを生成します
3. サーバーはこのクライアントを使って、適切な型付けで API を呼び出します
4. エラー処理とレスポンスの整形により、スムーズに利用できます

ライセンス

MIT