feat(flightradar24-mcp-server): add new server (#49)

Co-authored-by: Jiří Spilka <[email protected]>

Author: ivanvia7

flightradar24-mcp-server/.actor/actor.json

@@ -0,0 +1,19 @@
+{
+	"actorSpecification": 1,
+	"name": "flightradar24-mcp-server",
+	"title": "Flightradar24 MCP Server",
+	"description": "MCP server for real-time flight tracking using Flightradar24 data.",
+	"version": "0.1",
+	"buildTag": "latest",
+	"usesStandbyMode": true,
+	"meta": {
+		"templateId": "ts-mcp-server"
+	},
+	"env": [
+		{ "name": "FR24_API_KEY", "description": "Your Flightradar24 API key", "required": true },
+		{ "name": "FR24_API_URL", "description": "Flightradar24 API base URL", "required": false }
+	],
+	"payPerEvent": "./pay_per_event.json",
+	"dockerfile": "../Dockerfile",
+	"webServerMcpPath": "/mcp"
+}

flightradar24-mcp-server/.actor/pay_per_event.json

@@ -0,0 +1,17 @@
+{
+    "actor-start": {
+        "eventTitle": "Price for Actor start",
+        "eventDescription": "Flat fee for starting an Actor run.",
+        "eventPriceUsd": 0.1
+    },
+    "get_flight_positions": {
+        "eventTitle": "Get real-time flight positions",
+        "eventDescription": "Flat fee for each get_flight_positions tool call.",
+        "eventPriceUsd": 0.03
+    },
+    "get_flight_eta": {
+        "eventTitle": "Get estimated arrival time for a flight",
+        "eventDescription": "Flat fee for each get_flight_eta tool call.",
+        "eventPriceUsd": 0.02
+    }
+}

flightradar24-mcp-server/.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+end_of_line = lf

flightradar24-mcp-server/.gitignore

@@ -0,0 +1,14 @@
+# This file tells Git which files shouldn't be added to source control
+
+.idea
+.vscode
+.zed
+storage
+apify_storage
+crawlee_storage
+node_modules
+dist
+tsconfig.tsbuildinfo
+
+# Added by Apify CLI
+.venv

flightradar24-mcp-server/.prettierignore

@@ -0,0 +1 @@
+.prettierignore

flightradar24-mcp-server/.prettierrc

@@ -0,0 +1,5 @@
+{
+    "printWidth": 120,
+    "singleQuote": true,
+    "tabWidth": 4
+}

flightradar24-mcp-server/Dockerfile

@@ -0,0 +1,41 @@
+# ---- Build stage ----
+FROM apify/actor-node:22 AS builder
+WORKDIR /usr/src/app
+
+# Copy whole repo (dist/node_modules ignored by .dockerignore)
+COPY . .
+
+# Install root deps from lockfile (includes dev deps for building)
+RUN npm ci --include=dev --audit=false
+
+# Build inner MCP server (supports single or double nested layout)
+RUN set -eux; \
+    if [ -d "flightradar24-mcp-server/flightradar24-mcp-server" ]; then \
+        INNER="flightradar24-mcp-server/flightradar24-mcp-server"; \
+    elif [ -d "flightradar24-mcp-server" ]; then \
+        INNER="flightradar24-mcp-server"; \
+    else \
+        echo "Inner MCP server folder not found" >&2; exit 1; \
+    fi; \
+    npm ci --include=dev --audit=false --prefix "$INNER"; \
+    npm run build --prefix "$INNER"; \
+    test -f "$INNER/dist/index.js" || (echo "Missing $INNER/dist/index.js" >&2; ls -R "$INNER"; exit 1)
+
+# Build outer actor (TypeScript -> dist)
+RUN npm run build
+
+# ---- Runtime stage ----
+FROM apify/actor-node:22
+WORKDIR /usr/src/app
+
+# Copy built app and node_modules from builder
+COPY --from=builder /usr/src/app /usr/src/app
+
+# Production env
+ENV NODE_ENV=production
+
+# Optionally prune dev deps to slim image (safe even if none)
+RUN npm prune --omit=dev || true
+
+# Start the Actor (HTTP MCP proxy server)
+CMD ["node", "dist/main.js"]

flightradar24-mcp-server/README.md

@@ -0,0 +1,58 @@
+
+
+# Flightradar24 MCP Server
+
+A Model Context Protocol (MCP) server for real-time flight tracking using Flightradar24 data, published as an Apify Actor. This server enables MCP clients to access live flight positions and estimated arrival times via a standardized API.
+
+**About this MCP Server:** To understand how to connect to and utilize this MCP server, please refer to the official Model Context Protocol documentation at [mcp.apify.com](https://mcp.apify.com).
+
+[![Apify Badge](https://apify.com/actor-badge?actor=mcp-server/flightradar24-mcp-server)](https://apify.com/mcp-server/flightradar24-mcp-server)
+
+## Connection URL
+MCP clients can connect to this server at:
+
+```text
+https://mcp-servers--flightradar24-mcp-server.apify.actor/mcp
+```
+
+## Client Configuration
+To connect to this MCP server, use the following configuration in your MCP client:
+
+```json
+{
+    "mcpServers": {
+        "flightradar24": {
+            "url": "https://mcp-servers--flightradar24-mcp-server.apify.actor/mcp",
+            "headers": {
+                "Authorization": "Bearer YOUR_APIFY_TOKEN"
+            }
+        }
+    }
+}
+```
+
+**Note:** Replace `YOUR_APIFY_TOKEN` with your actual Apify API token. You can find your token in the [Apify Console](https://console.apify.com/account/integrations).
+
+## 🚩 Claim this MCP server
+All credits to the original authors of <https://github.com/sunsetcoder/flightradar24-mcp-server>
+To claim this server, please write to [[email protected]](mailto:[email protected]).
+
+---
+
+## Available tools
+
+- **get_flight_positions**: Get real-time flight positions with various filtering options (airports, bounds, categories, limit)
+- **get_flight_eta**: Get estimated arrival time for a specific flight (by flight number)
+
+## References
+To learn more about Apify and Actors, take a look at the following resources:
+- [Apify SDK for JavaScript documentation](https://docs.apify.com/sdk/js)
+- [Apify SDK for Python documentation](https://docs.apify.com/sdk/python)
+- [Apify Platform documentation](https://docs.apify.com/platform)
+- [Apify MCP Server](https://docs.apify.com/platform/integrations/mcp)
+- [Webinar: Building and Monetizing MCP Servers on Apify](https://www.youtube.com/watch?v=w3AH3jIrXXo)
+- [Join our developer community on Discord](https://discord.com/invite/jyEM2PRvMU)
+
+---
+
+For the full MCP server source code and more details, see the [mcp-servers GitHub repository](https://github.com/apify/mcp-servers).

flightradar24-mcp-server/eslint.config.mjs

@@ -0,0 +1,30 @@
+import prettier from 'eslint-config-prettier';
+
+import apify from '@apify/eslint-config/ts.js';
+import globals from 'globals';
+import tsEslint from 'typescript-eslint';
+
+// eslint-disable-next-line import/no-default-export
+export default [
+    { ignores: ['**/dist', 'eslint.config.mjs'] },
+    ...apify,
+    prettier,
+    {
+        languageOptions: {
+            parser: tsEslint.parser,
+            parserOptions: {
+                project: 'tsconfig.json',
+            },
+            globals: {
+                ...globals.node,
+                ...globals.jest,
+            },
+        },
+        plugins: {
+            '@typescript-eslint': tsEslint.plugin,
+        },
+        rules: {
+            'no-console': 0,
+        },
+    },
+];

flightradar24-mcp-server/flightradar24-mcp-server/.env.example

@@ -0,0 +1,6 @@
+# Flightradar24 API Configuration
+FR24_API_KEY=your-api-key-here
+# Flightradar24 API URL, shouldn't need to change this
+FR24_API_URL=https://fr24api.flightradar24.com
+# Server Configuration
+PORT=3000