AirLabs

Servidor MCP de AirLabs

Este servidor de Protocolo de Contexto de Modelo (MCP) proporciona acceso a la API de datos de aviación de AirLabs. Permite que asistentes de IA como Claude Desktop y Cursor accedan a datos de vuelos en tiempo real, horarios de aeropuertos, retrasos y bases de datos de referencia para aerolíneas, aeropuertos, flotas de aeronaves y rutas, directamente mediante preguntas en lenguaje natural.

Todo el servidor reside en un único archivo (index.ts): definiciones de herramientas, el cliente HTTP de AirLabs, el manejo de solicitudes y el transporte stdio.

Características

• Estado de vuelo en vivo — consulta cualquier vuelo por número y obtén estado, puerta, terminal y retraso.
• Horarios de aeropuertos — tableros de salidas y llegadas para cualquier aeropuerto.
• Monitoreo de retrasos — encuentra vuelos retrasados más allá de un umbral en un aeropuerto o aerolínea.
• Posiciones en tiempo real — coordenadas de aeronaves en vivo, altitud, velocidad y rumbo por área, aerolínea o matrícula.
• Aeropuerto más cercano — aeropuertos más cercanos a cualquier coordenada.
• Bases de datos de referencia — aerolíneas, aeropuertos, flotas de aeronaves (por número de cola o hex ICAO24) y redes de rutas.
• Resolución de códigos — convierte un lugar o nombre de aerolínea en su código IATA/ICAO.

Requisitos previos

1. Node.js 18.0.0 o superior.
2. Clave API de AirLabs — obtén una clave gratuita en https://airlabs.co/signup.

Instalación

Vía npm

npm install -g @airlabs-co/airlabs-mcp

Configuración

Integración con Claude Desktop

Añade esto a tu claude_desktop_config.json:

{
  "mcpServers": {
    "airlabs": {
      "command": "npx",
      "args": ["@airlabs-co/airlabs-mcp@latest"],
      "env": {
        "AIRLABS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Notas:

• Reemplaza your_api_key_here con tu clave API real de AirLabs.
• Reinicia Claude Desktop después de editar la configuración.
• Si compilas desde el código fuente localmente, usa "command": "node", "args": ["/path/to/build/index.js"].

Otros clientes MCP

Ejecuta el servidor directamente sobre stdio:

AIRLABS_API_KEY=your_api_key_here npx @airlabs/airlabs-mcp

Herramientas disponibles

Herramienta	Endpoint de AirLabs	Propósito
get_flight_status	/flight	Estado en vivo de un vuelo por número IATA/ICAO
get_airport_schedule	/schedules	Tablero de salidas / llegadas para un aeropuerto
monitor_delays	/delays	Vuelos retrasados más allá de un umbral
track_live_flights	/flights	Posiciones de aeronaves en vivo por área, aerolínea o matrícula
find_nearest_airport	/nearby	Aeropuertos más cercanos a una coordenada
search_airport_code	/suggest	Resolver un nombre a un código IATA/ICAO
get_airline_info	/airlines	Detalles de aerolínea por código
get_airport_info	/airports	Detalles de aeropuerto por código
lookup_aircraft	/fleets	Aeronave por matrícula o hex ICAO24
find_routes	/routes	Qué aerolíneas operan una ruta determinada

Todas las herramientas aceptan un parámetro opcional _fields (donde el endpoint lo admita) para devolver solo los campos seleccionados y mantener las respuestas compactas.

Ejemplos de uso

Una vez configurado, simplemente pregunta a tu asistente:

• "¿El vuelo BA117 está a tiempo?" → get_flight_status
• "¿Qué vuelos salen de JFK hoy?" → get_airport_schedule
• "¿Hay llegadas retrasadas en LAX por más de 30 minutos?" → monitor_delays
• "Muéstrame aviones volando sobre Nueva York." → track_live_flights
• "¿Qué aeronave es la matrícula N790AN?" → lookup_aircraft
• "¿Qué aerolíneas vuelan de Londres a Tokio?" → find_routes

Desarrollo

Compilar desde el código fuente

git clone https://github.com/airlabs-co/airlabs-mcp.git
cd airlabs-mcp
npm install
npm run build

Contribuciones

1. Haz un fork del repositorio.
2. Crea una rama de funcionalidad.
3. Realiza tus cambios.
4. Envía una solicitud de extracción.

Soporte

• Documentación: https://airlabs.co/docs
• Problemas: Problemas de GitHub
• Soporte de API: https://airlabs.co/faq#Contact

Licencia

Licencia MIT — consulta LICENCIA.