Aviation Weather

by mariow

291 downloads
Not rated
GitHub

About

Aviation weather briefings directly in Claude. METARs, TAFs, PIREPs, SIGMETs, and ICON-D2 NWP forecasts — no API key required.

Details

Author
mariow
Downloads
291
Categories
Media

- Access METARs, TAFs, PIREPs, and SIGMETs worldwide
- ICON‑D2 high‑resolution forecasts (2 km) for Central Europe
- Falls back to ICON‑EU (7 km, 120 h) outside Central Europe
- Automatic ICAO code resolution — just use the 4‑letter code
- Visibility reported in kilometers
- No API key or registration needed

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Aviation Weather
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install by adding the server to Claude Desktop’s MCP config using npx -y aviation-weather-mcp. After restarting Claude, ask plain‑language questions like “METAR EDDM” or “Route weather EDDM to LOWI”. For Claude Code, run claude mcp add aviation-weather -- npx -y aviation-weather-mcp.

wx_metar

Get the latest METAR for an airport. Returns raw METAR plus decoded ceiling, visibility, wind, and VFR/MVFR/IFR/LIFR flight category.

wx_taf

Get the Terminal Area Forecast (TAF) for an airport. Returns raw TAF plus decoded forecast periods with flight category, wind, visibility, and ceiling.

wx_pireps

Get pilot reports (PIREPs) near an airport. Reports recent turbulence, icing, cloud tops, and other in-flight observations.

wx_sigmets

Get active SIGMETs and AIRMETs. Filter by region to reduce noise.

wx_icon_d2

Get DWD ICON-D2 NWP forecast for any lat/lon. Provides hourly wind (10m + 80m), visibility, cloud base, precipitation, and CAPE. ICON-D2 covers Central Europe at 2km resolution up to 48h. Falls back to ICON-EU (7km, Europe) or ICON-seamless outside coverage.

wx_outlook

Longer-range VFR confidence outlook (3–15 days) for an airfield or location. Pools an ensemble (ECMWF-ENS for low cloud; ECMWF-ENS + GEFS for CAPE) and reports, per day, the probability that the day is NO-GO — the share of ensemble members with poor VFR conditions (low cloud above threshold OR high CAPE/thunderstorm potential) during the daylight window. Also shows the deterministic ECMWF-IFS trend, plus the ICON-EU run (≤5 days) as an independent medium-range cross-check that sits between ICON-D2 (48h) and ECMWF (15d). This is the confidence measure for trip planning that short-range METAR/TAF/ICON-D2 cannot provide. Pass an ICAO code (resolved offline from a bundled airport database covering GA fields) or lat/lon directly.

wx_preflight

VFR preflight weather brief for an airfield. Combines current METAR, TAF, and ICON-D2 NWP forecast into a single assessment. Only the ICAO code is required — coordinates are resolved authoritatively from the aviationweather.gov station database. Never supply coordinates yourself.

wx_route

Route weather brief for a direct flight between two airports. Fetches METARs at departure and destination, ICON-D2 at 5 points along the great-circle route, and active SIGMETs. Coordinates are resolved from the station API — never guess them. Pass ICAO codes exactly as given by the user.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "aviation weather": {
            "aviation-weather": {
                "command": "npx",
                "args": [
                    "-y",
                    "aviation-weather-mcp"
                ]
            }
        }
    }
}

McpServers

{
    "aviation-weather": {
        "command": "npx",
        "args": [
            "-y",
            "aviation-weather-mcp"
        ]
    }
}

Aviation Weather MCP Server

Aviation weather briefings directly in Claude. METARs, TAFs, PIREPs, SIGMETs, and ICON-D2 NWP forecasts — no API key required.

Just ask Claude things like:
- "METAR EDDM"
- "Preflight briefing EDLI"
- "Route weather EDDM to LOWI"
- "Any SIGMETs over Germany?"

Prerequisites

You need two things installed:

1. Claude Desktop — download from https://claude.ai/download
2. Node.js (version 18 or later) — download from https://nodejs.org (pick the LTS version)

To check if Node.js is already installed, open Terminal (Mac) or Command Prompt (Windows) and type:

node --version

If you see a version number like v22.x.x, you're good to go.

Setup (3 minutes)

Step 1: Open the Claude Desktop config

1. Open Claude Desktop
2. Click the gear icon (top right) to open Settings
3. Go to Developer
4. Click Edit Config

This opens a JSON file in your text editor.

Step 2: Add the weather server

If the file is empty or just has {}, replace it with:

{
  "mcpServers": {
    "aviation-weather": {
      "command": "npx",
      "args": ["-y", "aviation-weather-mcp"]
    }
  }
}

If the file already has content (e.g. other MCP servers), add the "aviation-weather" block inside the existing "mcpServers" section.

Step 3: Restart Claude Desktop

Quit Claude Desktop completely and reopen it. The first start may take 10-15 seconds longer while it downloads the weather server.

Step 4: Test it

Start a new chat and ask: "METAR EDDF"

Claude should respond with the current weather at Frankfurt airport. If it works, you're all set!

What can it do?

| Ask Claude... | What it does |
|---------------|-------------|
| "METAR EDDM" | Current weather at Munich airport |
| "TAF EDDF" | Forecast for Frankfurt |
| "Preflight briefing EDLI" | Full VFR brief: METAR + TAF + NWP forecast |
| "Route weather EDDM to LOWI" | Weather along a direct route (METARs + NWP + SIGMETs) |
| "Any PIREPs near EDDK?" | Recent pilot reports near Cologne |
| "SIGMETs over Germany" | Active significant weather warnings |
| "Hourly forecast for 48.14, 11.57" | ICON-D2 NWP model data for any coordinates |

Data Sources

- aviationweather.gov — METARs, TAFs, PIREPs, SIGMETs (FAA/NOAA, worldwide)
- Open-Meteo — ICON-D2 / ICON-EU NWP forecasts (DWD models)

Notes

- Works worldwide for METARs, TAFs, PIREPs, and SIGMETs
- ICON-D2 high-resolution forecasts (2km) cover Central Europe (43-58°N / 4-21°E, 48h horizon)
- Outside Central Europe, it falls back to ICON-EU (7km resolution, 120h horizon)
- ICAO codes are resolved automatically — just use the 4-letter code
- Visibility is reported in km

Usage with Claude Code

claude mcp add aviation-weather -- npx -y aviation-weather-mcp

Troubleshooting

Claude doesn't show weather tools: Make sure you restarted Claude Desktop after editing the config. Check that the JSON syntax is valid (no trailing commas, matching brackets).

"npx: command not found": Node.js is not installed or not in your PATH. Download it from https://nodejs.org.

Slow first start: The first time, npx downloads the package (~30KB). After that it's cached and starts instantly.

Disclaimer

This tool is for informational purposes only and is not a replacement for an official pre-flight weather briefing. Always use approved weather services and follow your national aviation authority's requirements for flight preparation.

License

MIT

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.