MCP HubMCP Hub
sunsetcoder

flightradar24-mcp-server

by: sunsetcoder

Model Context Protocol server for Flight Tracking

21created 13/12/2024
Visit
Protocol
Tracking

📌Overview

Purpose: To provide a real-time flight tracking solution using Flightradar24 data for aviation enthusiasts and travel planners.

Overview: The Flightradar24 MCP Server is a Claude Desktop application that allows users to track flights in real-time. It offers functionalities for checking flight statuses, monitoring arrivals and departures, and identifying emergency flights, making it an invaluable tool for anyone interested in aviation.

Key Features:

  • Real-time Flight Tracking: Users can track any flight live, providing up-to-date information on its location and status.

  • Flight Status Overview: Get specific arrival and departure times as well as the general status of flights at different airports, enhancing travel planning capabilities.

  • Emergency Flight Monitoring: Allows users to identify and monitor emergency flights, vital for safety and awareness purposes.


Flightradar24 MCP Server 🛩️

A Claude Desktop MCP server to track flights in real-time using Flightradar24 data. Ideal for aviation enthusiasts and travel planners.

Features ✨

  • Track any flight in real-time
  • Get arrival and departure times for specific flights
  • View flight status at an airport
  • Monitor emergency flights

Setup Guide 🚀

Prerequisites

Installation

  1. Clone this repository:

    git clone https://github.com/sunsetcoder/flightradar24-mcp-server.git
    
  2. Install dependencies and build the project:

    cd flightradar24-mcp-server
    npm install
    npm run build
    

Integration with Claude Desktop

  1. Open your Claude Desktop configuration file:

    • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%/Claude/claude_desktop_config.json
  2. Add to the mcpServers object in your config:

    {
      "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"
          }
        }
      }
    }
    
    • Replace /FULL/PATH/TO/flightradar24-mcp-server with the actual path.
    • Use forward slashes (/) in the path, even on Windows.
  3. Restart Claude Desktop for changes to take effect.

Environment Setup

  1. Copy .env.example to .env:

    cp .env.example .env
    
  2. Update the .env file with your Flightradar24 API key:

    FR24_API_KEY=your_actual_api_key_here
    

    Note: The .env file is ignored by git for security reasons.

Usage 🎮

Once configured, you can ask Claude questions like:

  • "What's the ETA for flight UA123?"
  • "Show me all flights at SFO"
  • "Are there any emergency flights nearby?"

Example conversation:

You: What's the status of flight UA123?
Claude: Let me check that for you...

Troubleshooting 🤔

Common Issues

  • "Claude can't connect to the server"

    • Check the path in your config file.
    • Verify your API key is correct.
  • "The server isn't responding"

    • Ensure your API key is valid.
    • Check if the API URL is correct.

FlightRadar API Access

  • A subscription to Flightradar24's API is required.

Support 🆘

  1. Verify Claude Desktop installation.
  2. Ensure your Flightradar24 API key is active.
  3. Check your configuration file path.
  4. Review error messages in server logs.

License 📄

MIT


Made with ❤️ for aviation enthusiasts.