Flightradar24

Acompanhe voos em tempo real usando dados do Flightradar24.

GitHub
47

Documentação

Flightradar24 MCP Server 🛩️

Um servidor MCP do Claude Desktop que ajuda você a rastrear voos em tempo real usando dados do Flightradar24. Perfeito para entusiastas da aviação, planejadores de viagem ou qualquer pessoa curiosa sobre os voos acima de você!

O que isso pode fazer? ✨

  • 🔍 Rastreie qualquer voo em tempo real
  • ⏰ Obtenha horários de chegada e partida para voos específicos
  • 🌉 Veja o status dos voos em um aeroporto
  • 🚨 Monitore voos de emergência
Anthropic Claude MCP Hackathon - FlightRadar24 MCP server

Guia de Configuração 🚀

1. Pré-requisitos

2. Instalação

  1. Clone este repositório em algum lugar do seu computador:

    git clone https://github.com/sunsetcoder/flightradar24-mcp-server.git

  2. Instale as dependências e compile o projeto:

    cd flightradar24-mcp-server
npm install
npm run build

3. Integração com o Claude Desktop

  1. Abra o arquivo de configuração do Claude Desktop:

    # On Mac:
~/Library/Application Support/Claude/claude_desktop_config.json

# On Windows:
%APPDATA%/Claude/claude_desktop_config.json

  2. Adicione o seguinte ao objeto mcpServers na sua configuração:

    {
  "mcpServers": {
    "flightradar24-server": {
      "command": "node",
      "args": [
        "/Users/<username>/<FULL_PATH...>/flightradar24-mcp-server/dist/index.js"
      ],
      "env": {
        "FR24_API_KEY": "your_api_key_here",
        "FR24_API_URL": "https://fr24api.flightradar24.com"
      }
    }
  }
}

  3. Passos importantes:

    • Substitua /FULL/PATH/TO/flightradar24-mcp-server pelo caminho completo real para onde você clonou o repositório
    • Adicione sua chave da API do Flightradar24 na seção env
    • Certifique-se de usar barras normais (/) no caminho, mesmo no Windows

  4. Reinicie o Claude Desktop para que as alterações tenham efeito

Configuração do Ambiente

  1. Copie .env.example para .env:

    cp .env.example .env

  2. Atualize o arquivo .env com sua chave real da API do Flightradar24:

    FR24_API_KEY=your_actual_api_key_here

Nota: Nunca envie sua chave real da API para o controle de versão. O arquivo .env é ignorado pelo git por motivos de segurança.

Vamos Experimentar! 🎮

Depois que o servidor estiver configurado, você pode fazer perguntas ao Claude, como:

  1. "Qual é o horário previsto de chegada para o voo UA123 da United Airlines?"
  2. "Mostre-me todos os voos atualmente em SFO"
  3. "Há algum voo de emergência na área?"
  4. "Mostre-me todos os voos internacionais chegando em SFO nas próximas 2 horas"
  5. "Quantos voos comerciais estão atualmente sobre o Oceano Pacífico?"
  6. "Identifique quaisquer voos que tenham declarado emergência na região da Califórnia"

Exemplo de conversa com o Claude:

You: What's the status of flight UA123?
Claude: Let me check that for you...
[Claude will use the MCP server to fetch real-time flight information]

Perguntas Frequentes e Solução de Problemas 🤔

"O Claude não consegue se conectar ao servidor"

  • Verifique se o caminho em claude_desktop_config.json está correto
  • Certifique-se de estar usando o caminho absoluto completo
  • Verifique se sua chave da API está correta
  • Tente reiniciar o Claude Desktop

"O servidor não está respondendo"

  • Certifique-se de que sua chave da API do Flightradar24 é válida
  • Verifique se a URL da API está correta
  • Procure por mensagens de erro nos logs do servidor

Acesso à API do FlightRadar

  • Nota: O uso da API do Flightradar24 requer uma assinatura

Precisa de mais ajuda? 🆘

  1. Certifique-se de que o Claude Desktop está instalado corretamente
  2. Verifique se sua chave da API do Flightradar24 está ativa
  3. Verifique se o caminho no seu arquivo de configuração está correto
  4. Procure por mensagens de erro nos logs do servidor MCP

Licença 📄

MIT

Feito com ❤️ para entusiastas da aviação