Flightradar24

Sigue vuelos en tiempo real usando datos de Flightradar24.

GitHub
47

Documentación

Servidor MCP de Flightradar24 🛩️

Un servidor MCP para Claude Desktop que te ayuda a rastrear vuelos en tiempo real usando datos de Flightradar24. ¡Perfecto para entusiastas de la aviación, planificadores de viajes o cualquier persona curiosa sobre los vuelos que pasan por encima!

¿Qué puede hacer esto? ✨

  • 🔍 Rastrear cualquier vuelo en tiempo real
  • ⏰ Obtener horas de llegada y salida para vuelos específicos
  • 🌉 Ver el estado de los vuelos en un aeropuerto
  • 🚨 Monitorear vuelos de emergencia
Anthropic Claude MCP Hackathon - FlightRadar24 MCP server

Guía de configuración 🚀

1. Requisitos previos

2. Instalación

  1. Clona este repositorio en algún lugar de tu computadora:

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

  2. Instala las dependencias y compila el proyecto:

    cd flightradar24-mcp-server
npm install
npm run build

3. Integración con Claude Desktop

  1. Abre tu archivo de configuración de Claude Desktop:

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

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

  2. Agrega lo siguiente al objeto mcpServers en tu configuración:

    {
  "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. Pasos importantes:

    • Reemplaza /FULL/PATH/TO/flightradar24-mcp-server con la ruta completa real donde clonaste el repositorio
    • Agrega tu clave API de Flightradar24 en la sección env
    • Asegúrate de usar barras diagonales (/) en la ruta, incluso en Windows

  4. Reinicia Claude Desktop para que los cambios surtan efecto

Configuración del entorno

  1. Copia .env.example a .env:

    cp .env.example .env

  2. Actualiza el archivo .env con tu clave API real de Flightradar24:

    FR24_API_KEY=your_actual_api_key_here

Nota: Nunca subas tu clave API real al control de versiones. El archivo .env está ignorado por git por razones de seguridad.

¡Probémoslo! 🎮

Una vez que el servidor esté configurado, puedes hacerle preguntas a Claude como:

  1. "¿Cuál es la hora estimada de llegada para el vuelo UA123 de United Airlines?"
  2. "Muéstrame todos los vuelos actualmente en SFO"
  3. "¿Hay algún vuelo de emergencia en el área?"
  4. "Muéstrame todos los vuelos internacionales que llegan a SFO en las próximas 2 horas"
  5. "¿Cuántos vuelos comerciales están actualmente sobre el Océano Pacífico?"
  6. "Identifica cualquier vuelo que haya declarado una emergencia en la región de California"

Ejemplo de conversación con 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]

Preguntas frecuentes y solución de problemas 🤔

"Claude no puede conectarse al servidor"

  • Verifica si la ruta en claude_desktop_config.json es correcta
  • Asegúrate de usar la ruta absoluta completa
  • Verifica que tu clave API sea correcta
  • Intenta reiniciar Claude Desktop

"El servidor no responde"

  • Asegúrate de que tu clave API de Flightradar24 sea válida
  • Verifica si la URL de la API es correcta
  • Busca mensajes de error en los registros del servidor

Acceso a la API de FlightRadar

  • Nota: Usar la API de Flightradar24 requiere una suscripción

¿Necesitas más ayuda? 🆘

  1. Asegúrate de que Claude Desktop esté instalado correctamente
  2. Verifica que tu clave API de Flightradar24 esté activa
  3. Comprueba que la ruta en tu archivo de configuración sea correcta
  4. Busca mensajes de error en los registros del servidor MCP

Licencia 📄

MIT

Hecho con ❤️ para entusiastas de la aviación