Uses the official Aviation Weather API Swagger definition to generate a type-safe API client that ensures proper typing and formatting for API calls.
Aviation Weather MCP Server
This is a Model Context Protocol (MCP) server that provides aviation weather information for flight planning. It connects to the Aviation Weather API to fetch METARs, TAFs, PIREPs, and other data.
DISCLAIMER
DO NOT USE THIS TOOL FOR FLIGHT PLANNING OR IN-FLIGHT DECISION MAKING.
IMPORTANT DISCLAIMER: This Aviation Weather MCP server provides weather data sourced from aviationweather.gov for informational purposes only. The information provided by this tool should NEVER be used as the sole source for flight planning or in-flight decision making.
Weather data may be incomplete, delayed, or inaccurate. Additionally, the large language model interpreting this data may misunderstand or incorrectly represent critical information. Always consult official aviation weather sources and obtain a proper weather briefing from authorized providers before any flight.
This tool is not FAA-approved, is not a replacement for certified weather services, and should be used only as a supplementary reference. The developers assume no liability for decisions made based on information provided by this tool.
ALWAYS verify critical weather information through official channels.
Features
Type-safe API client automatically generated from the official Aviation Weather API Swagger definition
MCP tools for weather data:
get-metar
: Get current weather observationsget-taf
: Get terminal aerodrome forecastsget-pireps
: Get pilot reports near an airportget-route-weather
: Get comprehensive weather for a route between two airports
Setup
Prerequisites
Node.js 18 or higher
npm or yarn
curl (for fetching the Swagger YAML)
Installation
Clone this repository:
git clone https://github.com/yourusername/aviation-weather-mcp-server.git cd aviation-weather-mcp-serverInstall dependencies:
npm installBuild the server (this will fetch the latest Swagger definition, generate the API client, and compile the TypeScript):
npm run buildStart the server:
npm start
Using with Claude for Desktop
To use this server with Claude for Desktop:
Edit your Claude for Desktop configuration file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Windows:
%APPDATA%\Claude\claude_desktop_config.json
Add the server to the configuration:
{ "mcpServers": { "aviation-weather": { "command": "node", "args": [ "/absolute/path/to/aviation-weather-mcp-server/build/index.js" ] } } }Restart Claude for Desktop
Example Queries
Once connected to Claude, you can ask questions like:
"What's the current weather at KJFK?"
"Is there a TAF available for KORD?"
"I'm planning to fly from KBOS to KPHL tomorrow. What's the weather looking like?"
"Are there any PIREPs near KDEN?"
Development
Project Structure
src/index.ts
: Main server codepackages/aviation-weath-api
: Autogenerate API client for Aviation Weather .gov
Building the aviation weather client
The build process follows these steps:
npm run aviation-weather-api:clean
: delete the existing clientnpm run aviation-weather-api:fetch
: Fetches the latest Swagger definition from aviationweather.govnpm run aviation-weather-api:generate
: Generates a typed TypeScript client from the Swagger definition
Building and running the app
npm run build
: Build the javascript clientnpm run start
: Run the MCP server
Adding More Tools
To add new tools to the server, follow this pattern:
How It Works
The server fetches the latest Swagger definition from aviationweather.gov
The OpenAPI Generator creates a type-safe client from this definition
The server uses this client to make API calls with proper typing
Error handling and response formatting ensure a smooth experience
License
MIT
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Provides aviation weather information through a Model Context Protocol server, enabling access to METARs, TAFs, PIREPs, and route weather data for informational purposes only.
Related MCP Servers
- AsecurityFlicenseAqualityA Model Context Protocol server implementation that provides tools for querying flight information, weather data, and flight comfort metrics through Variflight services.Last updated -813816
- AsecurityFlicenseAqualityA Model Context Protocol server that provides current weather forecasts for specific locations and active weather alerts for US states.Last updated -2
- AsecurityAlicenseAqualityA Model Context Protocol server that provides comprehensive weather data and forecasts through the OpenWeatherMap API, enabling AI assistants to access real-time weather information, forecasts, air quality data, and location services.Last updated -1137MIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that provides real-time weather data and forecasts for any city.Last updated -14ISC License