Flightradar MCP Server

🚀 FlightRadar MCP Server

A Model Context Protocol (MCP) server that provides real-time flight tracking and status information using the AviationStack API.

✨ Features

This MCP server offers three main tools:

1. get_flight_data: Retrieve detailed flight information by the flight's IATA or ICAO code.
2. search_flights: Search for flights based on criteria such as airline, departure/arrival airport, and status.
3. get_flight_status: Obtain a human-readable status summary for a specific flight.

📦 Installation

Install via Smithery

To automatically install the flightradar-mcp-server for Claude Desktop via Smithery:

npx -y @smithery/cli install @Cyreslab-AI/flightradar-mcp-server --client claude

Prerequisites

• Node.js (v14 or higher)
• npm (v6 or higher)
• AviationStack API key (obtain at aviationstack.com)

Setup

1. Clone this repository:

   git clone https://github.com/Cyreslab-AI/flightradar-mcp-server.git
   cd flightradar-mcp-server
   

2. Install dependencies:

   npm install
   

3. Build the server:

   npm run build
   

4. Configure the server in the MCP settings file:

   For the Claude VSCode extension, add to ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:

   {
     "mcpServers": {
       "flightradar": {
         "command": "node",
         "args": [],
         "env": {},
         "prependEnv": true,
         "appendEnv": true,
         "cwd": "/path/to/flightradar-mcp-server",
         "name": "FlightRadar"
       }
     }
   }
   

Please ensure to replace /path/to/flightradar-mcp-server with the actual path.

💻 Usage Examples

Basic Usage

Get Flight Information

curl --location 'http://localhost:3000/api/v1/flight' \
--header 'Content-Type: application/json' \
--data-raw '{
    "operation": "get_flight_data",
    "args": {
        "flight_number": "LH297"
    }
}'

Search Flights

curl --location 'http://localhost:3000/api/v1/flight' \
--header 'Content-Type: application/json' \
--data-raw '{
    "operation": "search_flights",
    "args": {
        "airport": "SFO"
    }
}'

Get Flight Status

curl --location 'http://localhost:3000/api/v1/flight' \
--header 'Content-Type: application/json' \
--data-raw '{
    "operation": "get_flight_status",
    "args": {
        "flight_number": "DL456"
    }
}'

🔧 API Key Configuration

This server requires an AviationStack API key to run. You can obtain a free key (100 requests per month) at aviationstack.com.

The API key should be provided as an environment variable named AVIATIONSTACK_API_KEY in your MCP settings configuration.

📄 License

MIT