Registry / llm-agents / flightradar-mcp-server

flightradar-mcp-server

library0.1.2jsnpmunverified

The `flightradar-mcp-server` is a Model Context Protocol (MCP) server designed to provide real-time flight tracking and status information. It integrates with the AviationStack API to offer three core functionalities: retrieving detailed flight data by IATA/ICAO code, searching for flights based on various criteria (airline, airports, status), and summarizing flight statuses in a human-readable format. Currently at version 0.1.2, this package appears to be in an early development stage, focusing on extending AI agents like Claude with external flight information capabilities rather than being a standalone, general-purpose API. Its release cadence is ad-hoc given its early version, implying potential for rapid evolution. Key differentiators include its specific integration with the MCP protocol for AI agents, facilitating direct interaction with LLMs, and its direct use of AviationStack for flight data, providing a robust, specialized tool for conversational AI applications requiring flight information.

llm-agents http-networking

npm install flightradar-mcp-server

package ↗

INSTALL

IMPORT

SIG · FLIGHTRADAR-MCP-SE

flightradar-mcp-server

llm-agentsjavascriptv0.1.2

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Server Process

✓ This package is run as a Node.js process.

✗ import { startServer } from 'flightradar-mcp-server'

The server is started via `node build/index.js` after cloning and building the repository, not imported as a library into other JavaScript code.

AviationStack API Key

✓ The API key is passed via the AVIATIONSTACK_API_KEY environment variable.

✗ import { setApiKey } from 'flightradar-mcp-server'

Configuration, including the API key, is external to the server's code; direct programmatic API key setting is not exposed for consumers.

Model Context Protocol (MCP)

✓ Interaction occurs over MCP, typically initiated by an AI client like Claude.

✗ import { getFlightData } from 'flightradar-mcp-server'

Functions like `get_flight_data`, `search_flights`, and `get_flight_status` are protocol commands processed by the running server, not exportable JavaScript functions for direct programmatic calls.

Demonstrates the setup, build, and execution of the `flightradar-mcp-server` as a standalone Node.js process, including environment variable configuration for the AviationStack API key.

# Quickstart to set up and run the FlightRadar MCP Server # This assumes Node.js (v14+) and npm (v6+) are already installed. # 1. Clone the repository git clone https://github.com/Cyreslab-AI/flightradar-mcp-server.git cd flightradar-mcp-server # 2. Install project dependencies npm install # 3. Build the server (compiles TypeScript/JavaScript) npm run build # 4. Set your AviationStack API key and run the server # Replace 'YOUR_AVIATIONSTACK_API_KEY' with your actual key from aviationstack.com # The server will start and listen for MCP requests. AVIATIONSTACK_API_KEY="YOUR_AVIATIONSTACK_API_KEY" node build/index.js # To integrate with an MCP client (e.g., Claude Desktop), refer to the # 'Configure the server in your MCP settings file' section of the README.

Debug

Known issues

gotchaThis package is explicitly designed as a standalone Model Context Protocol (MCP) server, not a traditional JavaScript library for direct programmatic import. Attempting to `import` or `require` symbols from it will not work as its primary interaction model is via process execution and IPC with AI agents.

fix

Refer to the package's documentation for running the server as a separate process and configuring your MCP-compatible AI client to interact with it.

affects: >=0.1.0

gotchaAn active API key from AviationStack (obtained at aviationstack.com) is absolutely mandatory for this server to retrieve any flight data. Without it, all flight-related requests will fail. The key must be provided as the `AVIATIONSTACK_API_KEY` environment variable.

fix

Obtain a valid API key from aviationstack.com and ensure it is correctly set as the `AVIATIONSTACK_API_KEY` environment variable in the execution context of the server, typically within your MCP client's configuration.

affects: >=0.1.0

gotchaAs of version 0.1.2, this package is in an early development stage. This implies that the API, internal structure, and overall functionality may undergo significant, potentially breaking, changes in future minor or even patch releases without strict adherence to semantic versioning until a stable major release.

fix

Users should monitor the project's repository for updates, carefully review changelogs when upgrading, and be prepared for potential adjustments in their integration or configuration.

affects: >=0.1.0

Errors

Common errors & fixes

Error: API key is missing. Please set AVIATIONSTACK_API_KEY environment variable.

The `AVIATIONSTACK_API_KEY` environment variable was not set or was provided with an empty value when the server was started.

fix

Ensure `AVIATIONSTACK_API_KEY` is correctly configured with a valid API key from aviationstack.com in the environment where the server process runs. For MCP clients, this is typically done in the client's MCP server configuration JSON.

node: command not found

Node.js is not installed on the system or its executable path is not included in the system's PATH environment variable.

fix

Download and install the latest LTS version of Node.js (which includes npm) from nodejs.org, and verify its installation by running `node -v` and `npm -v` in your terminal.

Upgrade

Version history

0.1.2latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

25 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://www.npmjs.com/package/flightradar-mcp-server ↗