AirLabs

Servidor MCP AirLabs

Este servidor Model Context Protocol (MCP) fornece acesso à API de dados de aviação AirLabs. Ele permite que assistentes de IA, como Claude Desktop e Cursor, acessem dados de voos em tempo real, horários de aeroportos, atrasos e bancos de dados de referência para companhias aéreas, aeroportos, frotas de aeronaves e rotas — diretamente por meio de perguntas em linguagem natural.

O servidor inteiro reside em um único arquivo (index.ts): definições de ferramentas, o cliente HTTP da AirLabs, o tratamento de solicitações e o transporte stdio.

Recursos

• Status de voo em tempo real — consulte qualquer voo pelo número e obtenha status, portão, terminal e atraso.
• Horários de aeroportos — painéis de partidas e chegadas para qualquer aeroporto.
• Monitoramento de atrasos — encontre voos atrasados além de um limite em um aeroporto ou companhia aérea.
• Posições em tempo real — coordenadas, altitude, velocidade e direção de aeronaves ao vivo por área, companhia aérea ou registro.
• Aeroporto mais próximo — aeroportos mais próximos de qualquer coordenada.
• Bancos de dados de referência — companhias aéreas, aeroportos, frotas de aeronaves (por número de cauda ou hex ICAO24) e redes de rotas.
• Resolução de códigos — transforme um nome de lugar ou companhia aérea em seu código IATA/ICAO.

Pré-requisitos

1. Node.js 18.0.0 ou superior.
2. Chave da API AirLabs — obtenha uma chave gratuita em https://airlabs.co/signup.

Instalação

Via npm

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

Configuração

Integração com Claude Desktop

Adicione isto ao seu claude_desktop_config.json:

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

Observações:

• Substitua your_api_key_here pela sua chave real da API AirLabs.
• Reinicie o Claude Desktop após editar a configuração.
• Se você compilar a partir do código-fonte localmente, use "command": "node", "args": ["/path/to/build/index.js"].

Outros clientes MCP

Execute o servidor diretamente via stdio:

AIRLABS_API_KEY=your_api_key_here npx @airlabs/airlabs-mcp

Ferramentas disponíveis

Ferramenta	Endpoint AirLabs	Finalidade
get_flight_status	/flight	Status em tempo real de um voo por número IATA/ICAO
get_airport_schedule	/schedules	Painel de partidas / chegadas de um aeroporto
monitor_delays	/delays	Voos atrasados além de um limite
track_live_flights	/flights	Posições de aeronaves em tempo real por área, companhia aérea ou registro
find_nearest_airport	/nearby	Aeroportos mais próximos de uma coordenada
search_airport_code	/suggest	Resolver um nome para um código IATA/ICAO
get_airline_info	/airlines	Detalhes da companhia aérea por código
get_airport_info	/airports	Detalhes do aeroporto por código
lookup_aircraft	/fleets	Aeronave por registro ou hex ICAO24
find_routes	/routes	Quais companhias aéreas operam uma determinada rota

Todas as ferramentas aceitam um parâmetro opcional _fields (quando o endpoint suporta) para retornar apenas campos selecionados e manter as respostas compactas.

Exemplos de uso

Após a configuração, basta perguntar ao seu assistente:

• "O voo BA117 está no horário?" → get_flight_status
• "Quais voos estão saindo de JFK hoje?" → get_airport_schedule
• "As chegadas em LAX estão atrasadas em mais de 30 minutos?" → monitor_delays
• "Mostre-me aviões voando sobre Nova York." → track_live_flights
• "Qual aeronave tem o registro N790AN?" → lookup_aircraft
• "Quais companhias aéreas voam de Londres para Tóquio?" → find_routes

Desenvolvimento

Compilando a partir do código-fonte

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

Contribuindo

1. Faça um fork do repositório.
2. Crie um branch de recurso.
3. Faça suas alterações.
4. Envie um pull request.

Suporte

• Documentação: https://airlabs.co/docs
• Problemas: GitHub Issues
• Suporte da API: https://airlabs.co/faq#Contact

Licença

Licença MIT — consulte LICENSE.