关键词

航班追踪航空数据实时航班状态机场信息Flightradar24 API

Flightradar24 MCP Server 使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为LLM（如Claude）提供实时的航班信息查询能力。通过集成 Flightradar24 API，用户可以通过LLM客户端查询航班的实时状态、预计到达时间、机场航班动态以及紧急航班信息等。

主要功能点

  • 实时航班追踪: 追踪任何航班的实时位置和状态。
  • 航班 ETA 查询: 获取特定航班的预计到达和出发时间。
  • 机场航班动态: 查看指定机场的航班状态。
  • 紧急航班监控: 监测区域内的紧急航班。

安装步骤

  1. 克隆仓库: 将仓库代码克隆到本地： 
    git clone https://github.com/MCP-Mirror/sunsetcoder_flightradar24-mcp-server.git
cd flightradar24-mcp-server
  2. 安装依赖并构建: 运行以下命令安装项目依赖并构建项目： 
    npm install
npm run build
  3. 配置 Flightradar24 API 密钥:
    • 复制 '.env.example' 文件并重命名为 '.env'： 
      cp .env.example .env
    • 打开 '.env' 文件，将 'your_actual_api_key_here' 替换为您从 Flightradar24 官网申请的 API 密钥。

服务器配置

要将此 MCP 服务器集成到 MCP 客户端（例如 Claude Desktop），您需要配置客户端的 'claude_desktop_config.json' 文件。在 'mcpServers' 对象中添加以下配置：

{
  "mcpServers": {
    "flightradar24-server": {
      "command": "node",
      "args": [
        "/path/to/flightradar24-mcp-server/dist/index.js"
      ],
      "env": {
        "FR24_API_KEY": "YOUR_API_KEY",
        "FR24_API_URL": "https://fr24api.flightradar24.com"
      }
    }
  }
}

配置参数说明:

  • '"flightradar24-server"': 服务器名称，可以自定义。
  • '"command": "node"': 启动服务器的命令，这里使用 Node.js 运行时。
  • '"args": [...]': 启动命令的参数，指向编译后的服务器入口文件 'index.js' 的绝对路径。 请务必将 '/path/to/flightradar24-mcp-server' 替换为您本地仓库的实际绝对路径。
  • '"env": {...}': 环境变量配置。
    • '"FR24_API_KEY": "YOUR_API_KEY"': Flightradar24 API 密钥。 请将 '"YOUR_API_KEY"' 替换为您在 '.env' 文件中配置的 API 密钥。
    • '"FR24_API_URL": "https://fr24api.flightradar24.com"': Flightradar24 API 的 URL，通常无需修改。

注意:

  • 确保使用绝对路径配置 'args' 中的文件路径。
  • 配置文件路径示例：
    • macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
    • Windows: '%APPDATA%/Claude/claude_desktop_config.json'
  • 修改配置文件后，需要重启 MCP 客户端 (Claude Desktop) 使配置生效。

基本使用方法

配置完成后，您可以在 MCP 客户端中向 LLM 提出关于航班信息的问题。例如：

  • "UA123 航班的预计到达时间是什么时候？"
  • "显示旧金山国际机场 (SFO) 当前的所有航班。"
  • "附近是否有紧急航班？"
  • "查询未来两小时内到达旧金山国际机场的所有国际航班。"
  • "目前有多少架商业航班在太平洋上空飞行？"
  • "识别加利福尼亚地区是否有航班宣布紧急情况。"

LLM 客户端会将这些问题通过 MCP 协议发送到 'flightradar24-server'，服务器会调用 Flightradar24 API 获取数据，并将结果返回给 LLM 客户端。

信息

分类

网页与API

访问项目