Skip to content

AiAgentKarl/aviation-mcp-server

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Aviation MCP Server

MCP server giving AI agents access to real-time aviation data — live flight tracking, airport weather, airline and airport information.

Features

Tool Description Source
track_live_flights Current flights worldwide or in a specific area OpenSky Network
track_flight Track a specific flight by callsign or ICAO24 OpenSky Network
get_flight_path Historical flight path/trajectory OpenSky Network
get_airport_arrivals Recent arrivals at an airport OpenSky Network
get_airport_departures Recent departures from an airport OpenSky Network
get_airport_weather Current METAR weather at an airport AviationWeather.gov
get_weather_forecast TAF weather forecast for an airport AviationWeather.gov
get_aviation_warnings Active SIGMETs and aviation warnings AviationWeather.gov
get_airport_info Airport details (location, timezone, etc.) AirLabs
get_airline_info Airline details (fleet, hub, status) AirLabs

Data Sources

  • OpenSky Network — Live flight tracking, arrivals/departures, flight paths (no API key needed, 100 calls/day)
  • AviationWeather.gov — METAR, TAF, SIGMETs (no API key needed, 100 req/min)
  • AirLabs — Airport and airline database (free tier: 1,000 calls/month, API key required)

Installation

With pip

pip install aviation-mcp-server

From source

git clone https://github.com/AiAgentKarl/aviation-mcp-server.git
cd aviation-mcp-server
pip install -e .

Configuration

API Keys

Copy .env.example to .env and add your keys:

cp .env.example .env
# AirLabs — Optional (https://airlabs.co)
AIRLABS_API_KEY=your-key-here

Note: OpenSky Network and AviationWeather.gov require no API key. The AirLabs key is only needed for get_airport_info and get_airline_info.

Claude Desktop / Claude Code

Add to your MCP configuration:

{
  "mcpServers": {
    "aviation": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "src.server"],
      "env": {
        "AIRLABS_API_KEY": "your-key-here"
      }
    }
  }
}

Using uvx (no install needed)

{
  "mcpServers": {
    "aviation": {
      "type": "stdio",
      "command": "uvx",
      "args": ["aviation-mcp-server"],
      "env": {
        "AIRLABS_API_KEY": "your-key-here"
      }
    }
  }
}

Usage Examples

Track flights over Germany:

"Show me all flights currently over Germany"

Check airport weather:

"What's the current weather at Frankfurt Airport?"

Track a specific flight:

"Track Lufthansa flight DLH400"

Get airport arrivals:

"Show me recent arrivals at JFK"

Aviation warnings:

"Are there any active SIGMETs?"

Airport Codes

This server uses ICAO airport codes (4 letters) for weather and flight data:

Airport IATA ICAO
Frankfurt FRA EDDF
Munich MUC EDDM
Berlin BER EDDB
New York JFK JFK KJFK
London Heathrow LHR EGLL
Paris CDG CDG LFPG
Tokyo Narita NRT RJAA

Rate Limits

API Limit Auth
OpenSky Network 100 calls/day (anonymous) None
AviationWeather.gov 100 requests/minute None
AirLabs 1,000 calls/month (free tier) API Key

Tech Stack

  • Python 3.11+
  • MCP SDK (FastMCP)
  • httpx (async HTTP)
  • OpenSky Network, AviationWeather.gov, AirLabs APIs

More MCP Servers by AiAgentKarl

Category Servers
🔗 Blockchain Solana
🌍 Data Weather · Germany · Agriculture · Space · Aviation · EU Companies
🔒 Security Cybersecurity · Policy Gateway · Audit Trail
🤖 Agent Infra Memory · Directory · Hub · Reputation
🔬 Research Academic · LLM Benchmark · Legal

→ Full catalog (40+ servers)

License

MIT

About

MCP server for aviation data — Live flight tracking, airport weather, airline info

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors