aviation-weather-mcp

corygehr/aviation-weather-mcp

3.2

If you are the rightful owner of aviation-weather-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Aviation Weather MCP Server provides access to aviation weather data from aviationweather.gov, acting as a proxy to the API and returning data in JSON format.

Tools
9
Resources
0
Prompts
0

Aviation Weather MCP Server

An MCP (Model Context Protocol) server that provides access to aviation weather data from aviationweather.gov. This server acts as a proxy to the aviationweather.gov API, returning the same JSON format to MCP clients.

Features

The server provides access to nine types of aviation weather data:

  • METAR - Current weather observations from airports
  • TAF - Terminal Aerodrome Forecasts
  • PIREP - Pilot Reports
  • SIGMET/AIRMET - Significant meteorological information
  • GFA - Graphical Forecasts for Aviation
  • WINDTEMP - Winds and Temperatures Aloft forecasts
  • CWA - Center Weather Advisory from ARTCCs
  • ISIGMET - International SIGMET data
  • STATIONINFO - Airport and weather station information

Installation

From Source (Recommended)

pip install -e .

Using requirements.txt

pip install -r requirements.txt

Usage

As an MCP Server

First, install the package:

pip install -e .

Then run the server using:

aviation-weather-mcp

Or with Python module:

python -m aviation_weather_mcp.server

Development Usage (without installation)

For development, you can run the server directly from the source directory:

python -c "import sys; sys.path.insert(0, 'src'); from aviation_weather_mcp.server import main; main()"

Or:

PYTHONPATH=src python -m aviation_weather_mcp.server

Available Resources

The server exposes the following resources:

  • aviation-weather://metar - METAR weather reports
  • aviation-weather://taf - Terminal Aerodrome Forecasts
  • aviation-weather://pirep - Pilot Reports
  • aviation-weather://airsigmet - SIGMET and AIRMET data
  • aviation-weather://gfa - Graphical Forecasts for Aviation
  • aviation-weather://windtemp - Winds and Temperatures Aloft
  • aviation-weather://cwa - Center Weather Advisory
  • aviation-weather://isigmet - International SIGMET
  • aviation-weather://stationinfo - Airport and station information

Available Tools

The server provides the following tools for MCP clients:

get_metar

Get current weather observations from airports.

Required Parameters:

  • ids - Airport identifier(s) (e.g., "KJFK" or "KJFK,KLGA")

Optional Parameters:

  • hours - Number of hours to look back
get_taf

Get Terminal Aerodrome Forecasts.

Required Parameters:

  • ids - Airport identifier(s) (e.g., "KJFK" or "KJFK,KLGA")

Optional Parameters:

  • hours - Number of hours to look back
get_pirep

Get Pilot Reports.

Optional Parameters:

  • hours - Number of hours to look back
  • id - Airport identifier to center the search around (e.g., "KJFK")
  • distance - Distance in nautical miles from the center point (e.g., "100")
  • level - Altitude level filter
get_airsigmet

Get SIGMET and AIRMET data.

Optional Parameters:

  • hours - Number of hours to look back
  • id - Airport identifier to center the search around (e.g., "KJFK")
  • distance - Distance in nautical miles from the center point (e.g., "100")
  • level - Altitude level filter
  • type - Type filter for SIGMET/AIRMET
get_gfa

Get Graphical Forecasts for Aviation.

Optional Parameters:

  • hours - Number of hours to look back
  • level - Altitude level filter
  • fcst - Forecast period or validity time
  • region - Geographic region filter (e.g., us, conus, ak, hi)
get_windtemp

Get Winds and Temperatures Aloft forecasts.

Optional Parameters:

  • region - Geographic region filter (e.g., us, conus, ak, hi)
  • fcst - Forecast period or validity time
get_cwa

Get Center Weather Advisory from Air Route Traffic Control Centers.

Optional Parameters:

  • hours - Number of hours to look back
  • center - Air Route Traffic Control Center identifier
get_isigmet

Get International SIGMET data.

Optional Parameters:

  • hours - Number of hours to look back
  • level - Altitude level filter
  • type - Type filter for SIGMET
  • region - Geographic region filter
get_stationinfo

Get airport and weather station information.

Optional Parameters:

  • ids - Station identifier(s) (e.g., "KJFK" or "KJFK,KLGA")
  • bbox - Bounding box coordinates (minLon,minLat,maxLon,maxLat)
  • country - Country code filter (e.g., US, CA, MX)

Example Usage with MCP Client

Once connected to an MCP client, you can:

  1. Get METAR for JFK Airport:

    Use the get_metar tool with ids="KJFK"

  2. Get TAF for multiple airports:

    Use the get_taf tool with ids="KJFK,KLGA,KEWR"

  3. Get pilot reports around an airport:

    Use the get_pirep tool with id="KJFK" and distance="50" and hours="3"

  4. Get SIGMET/AIRMET data around an airport:

    Use the get_airsigmet tool with id="KORD" and distance="100"

  5. Get graphical aviation forecasts:

    Use the get_gfa tool with region="conus" and fcst="06"

  6. Get winds and temperatures aloft:

    Use the get_windtemp tool with region="us"

  7. Get Center Weather Advisory:

    Use the get_cwa tool with center="ZNY" and hours="6"

  8. Get station information:

    Use the get_stationinfo tool with ids="KJFK,KLGA"

Development

Testing

Run the basic functionality tests:

python tests/test_basic.py

This will verify that:

  • All imports work correctly
  • Server initializes properly
  • All resource types are configured
  • Handlers are set up correctly

API Data Source

This server proxies data from the aviationweather.gov API. The data returned is in the same JSON format as provided by the original API.

Requirements

  • Python 3.8+
  • httpx >= 0.24.0
  • mcp >= 1.0.0

License

Apache License 2.0