finack aviation mcp

WHAT IT CONNECTS

What finack aviation mcp gives an AI Agent

• **Type-safe API client** automatically generated from the official Aviation Weather API Swagger definition
• **MCP tools for weather data**:
• `get-metar`: Get current weather observations
• `get-taf`: Get terminal aerodrome forecasts
• `get-pireps`: Get pilot reports near an airport
• `get-route-weather`: Get comprehensive weather for a route between two airports
• Node.js 18 or higher
• npm or yarn
• curl (for fetching the Swagger YAML)
• Clone this repository:
• Install dependencies:
• Build the server (this will fetch the latest Swagger definition, generate the API client, and compile the TypeScript):
• Start the server:
• 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:
• Restart Claude for Desktop
• "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?"
• `src/index.ts`: Main server code
• `packages/aviation-weath-api`: Autogenerate API client for Aviation Weather .gov
• `npm run aviation-weather-api:clean`: delete the existing client
• `npm run aviation-weather-api:fetch`: Fetches the latest Swagger definition from aviationweather.gov
• `npm run aviation-weather-api:generate`: Generates a typed TypeScript client from the Swagger definition
• `npm run build`: Build the javascript client
• `npm run start`: Run the MCP server
• 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