flightradar24-mcp-server
by: sunsetcoder
Model Context Protocol server for Flight 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
- Claude Desktop installed
- Flightradar24 API key (obtain from Flightradar24)
Installation
-
Clone this repository:
git clone https://github.com/sunsetcoder/flightradar24-mcp-server.git
-
Install dependencies and build the project:
cd flightradar24-mcp-server npm install npm run build
Integration with Claude Desktop
-
Open your Claude Desktop configuration file:
- Mac:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%/Claude/claude_desktop_config.json
- Mac:
-
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.
- Replace
-
Restart Claude Desktop for changes to take effect.
Environment Setup
-
Copy
.env.example
to.env
:cp .env.example .env
-
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 🆘
- Verify Claude Desktop installation.
- Ensure your Flightradar24 API key is active.
- Check your configuration file path.
- Review error messages in server logs.
License 📄
MIT
Made with ❤️ for aviation enthusiasts.