Which integrations are available for this server?

Provides access to a local FAA aircraft registry database containing 93,000+ aircraft models, 306,000+ registered US aircraft, and 4,700+ engines, with tools for querying and enriching aircraft data.

✈️ Skyfly MCP Server

Python 3.10+ MCP Protocol License: MIT OpenSky Network

Un serveur MCP (Model Context Protocol) qui combine données de vol en temps réel et référentiel FAA pour créer des expériences IA riches en contexte aéronautique.

🌐 Demo live: skyfly.mcp.hamon.link

🎯 Qu'est-ce que c'est ?

Skyfly MCP est un serveur qui permet à des LLMs comme Claude ou ChatGPT d'accéder à :

📡 Données live (via OpenSky Network)
- Positions des avions en temps réel
- Trajectoires et historiques de vol
- Arrivées/départs par aéroport
🗄️ Référentiel FAA (base SQL locale)
- 93,000+ modèles d'aéronefs
- 306,000+ avions immatriculés US
- 4,700+ moteurs référencés

Résultat : Des requêtes intelligentes qui combinent position live + specs techniques !

🚀 Fonctionnalités

19 Outils MCP disponibles

Catégorie	Outils	Description
Live	`get_aircraft_states`	Positions actuelles des aéronefs
Live	`get_aircraft_in_region`	Aéronefs par zone (France, Europe...)
Live	`get_arrivals_by_airport`	Arrivées à un aéroport
Live	`get_departures_by_airport`	Départs d'un aéroport
Live	`get_track_by_aircraft`	Trajectoire d'un aéronef
SQL	`db_lookup_by_mode_s`	Enrichit un icao24 avec specs
SQL	`db_search_aircraft`	Recherche dans le registre FAA
SQL	`db_search_models`	Recherche modèles (Boeing, Cessna...)
SQL	`db_enrich_live_aircraft`	Enrichit une liste d'icao24
SQL	`db_sql_query`	Requête SQL personnalisée

📦 Installation

Prérequis

Python 3.10+
Certificat SSL (Let's Encrypt recommandé)

Installation rapide

# Cloner le repo git clone https://github.com/vog01r/skyfly-mcp.git cd skyfly-mcp # Créer l'environnement virtuel python3 -m venv venv source venv/bin/activate # Installer les dépendances pip install -r requirements.txt # Télécharger les données FAA (optionnel mais recommandé) # Depuis: https://www.faa.gov/licenses_certificates/aircraft_certification/aircraft_registry/releasable_aircraft_download mkdir ReleasableAircraft # Placer ACFTREF.txt, ENGINE.txt, MASTER.txt dans ce dossier # Lancer l'ingestion python -c " from aircraftdb.database import get_database from aircraftdb.ingest import ingest_directory from pathlib import Path db = get_database() ingest_directory(Path('ReleasableAircraft'), db) " # Démarrer le serveur ./start.sh

🔗 Configuration MCP

Pour Claude Desktop

Ajoutez dans votre configuration MCP :

{ "mcpServers": { "skyfly": { "url": "https://skyfly.mcp.hamon.link/sse" } } }

Auto-hébergé

{ "mcpServers": { "skyfly": { "url": "https://your-domain.com/sse" } } }

💡 Exemples de requêtes

Requête simple

"Montre-moi les avions au-dessus de la France"

Requête enrichie

"Pour les 5 avions au-dessus de Paris, donne-moi le propriétaire, le type d'appareil et le nombre de moteurs"

Requête analytique

"Combien de Boeing 737 sont dans le registre FAA ? Quels sont les 5 états avec le plus d'immatriculations ?"

Requête combinée

"Parmi les hélicoptères actuellement en vol aux USA, quel est le modèle le plus fréquent ?"

🏗️ Architecture

skyfly-mcp/ ├── http_server.py # Serveur MCP unifié (SSE + REST) ├── opensky_client.py # Client async OpenSky API ├── server.py # Serveur MCP stdio (usage local) ├── aircraftdb/ │ ├── database.py # SQLite avec schéma + CRUD │ ├── ingest.py # Ingestion fichiers FAA │ └── tools.py # Outils MCP AircraftDB ├── requirements.txt ├── setup_ssl.sh # Configuration Let's Encrypt ├── start.sh # Script de démarrage └── opensky-mcp.service # Service systemd

📊 Données FAA

Le référentiel FAA contient :

Table	Contenu	Source
`aircraft_models`	93K+ modèles	ACFTREF.txt
`aircraft_registry`	306K+ aéronefs US	MASTER.txt
`engines`	4.7K+ moteurs	ENGINE.txt

Téléchargement : FAA Releasable Aircraft Database

🔧 Déploiement Production

Avec Apache (reverse proxy)

<VirtualHost *:443> ServerName skyfly.yourdomain.com SSLEngine on SSLCertificateFile /etc/letsencrypt/live/skyfly.yourdomain.com/fullchain.pem SSLCertificateKeyFile /etc/letsencrypt/live/skyfly.yourdomain.com/privkey.pem ProxyPreserveHost On ProxyPass / http://127.0.0.1:8443/ ProxyPassReverse / http://127.0.0.1:8443/ </VirtualHost>

Service systemd

sudo cp opensky-mcp.service /etc/systemd/system/ sudo systemctl enable opensky-mcp sudo systemctl start opensky-mcp

🤝 Contribution

Les contributions sont les bienvenues !

Fork le projet
Créez une branche (git checkout -b feature/amazing-feature)
Committez (git commit -m 'Add amazing feature')
Push (git push origin feature/amazing-feature)
Ouvrez une Pull Request

📜 Licence

MIT License - voir LICENSE

🙏 Crédits

OpenSky Network - Données de vol en temps réel
FAA - Registre des aéronefs US
Anthropic MCP - Model Context Protocol

Skyfly MCP Server