Flightradar24/fr24api-mcp

# Flightradar24 MCP Server [](https://badge.fury.io/js/@flightradar24%2Ffr24api-mcp) [](https://opensource.org/licenses/MIT) 此 [Model Context Protocol (MCP)](https://modelcontextprotocol.io) 服务器提供了对 Flightradar24 API 的访问，用于获取实时和历史航班数据。该服务器使像 Claude 这样的 AI 助手能够访问全面的航空数据，包括实时航班位置、飞机信息、机场详情和航班历史。 ## 功能 - **实时航班追踪**：获取全球飞机的实时位置 - **历史航班数据**：访问追溯至 2016 年 5 月 11 日的航班数据 - **全面的航班信息**：详细的飞机、航空公司和机场数据 - **灵活的过滤**：按呼号、注册号、航线、机型等进行搜索 - **航班摘要**：完整的起飞和降落信息 - **飞机航迹**：特定航班的详细位置追踪 ## 安装 ### 通过 npm ``` npm install -g @flightradar24/fr24api-mcp ``` ## 前置条件 1. **Node.js**：18.0.0 或更高版本 2. **Flightradar24 API Key**：从 [https://fr24api.flightradar24.com](https://fr24api.flightradar24.com) 获取你的 API key ## 配置 ### Claude Desktop 集成 将此配置添加到你的 `claude_desktop_config.json` 文件中： ``` { "mcpServers": { "fr24api": { "command": "npx", "args": ["@flightradar24/fr24api-mcp@latest"], "env": { "FR24_API_KEY": "your_api_key_here" } } } } ``` **重要说明：** - 将 `your_api_key_here` 替换为你的实际 Flightradar24 API key - 添加配置后重启 Claude Desktop - 如果是本地安装，请使用完整路径：`"command": "node", "args": ["/path/to/build/index.js"]` ### 其他 MCP 客户端 对于其他 MCP 客户端，直接运行服务器： ``` FR24_API_KEY=your_api_key_here npx @flightradar24/fr24api-mcp ``` ## 可用工具 ### 实时航班数据 #### `get_live_flights_positions_light` 获取实时飞机位置及基本信息。 **参数**（至少需要一个）： - `bounds`：地理区域（北、南、西、东坐标） - `flights`：航班号（逗号分隔，最多 15 个） - `callsigns`：航班呼号（逗号分隔，最多 15 个） - `registrations`：飞机注册号（逗号分隔，最多 15 个） - `airports`：机场代码，可选方向（例如："inbound:JFK,outbound:LAX"） - `routes`：航线（例如："JFK-LAX,LHR-CDG"） - `aircraft`：飞机 ICAO 机型（逗号分隔，最多 15 个） - `altitude_ranges`：高度范围，单位为英尺（例如："0-3000,30000-40000"） - `categories`：航班类别（P,C,M,J,T,H,B,G,D,V,O,N） - `limit`：最大结果数（默认：无限制，最大：30000） #### `get_live_flights_positions_full` 获取实时飞机位置及全面的航班详情。 *参数同上* #### `get_live_flights_count` 获取匹配条件的实时航班数量。 *参数同上* ### 历史航班数据 #### `get_historic_flights_positions_full` 获取历史航班位置及完整详情。 **必选参数：** - `timestamp`：用于历史快照的 Unix 时间戳 **可选参数：** *与实时航班参数相同* #### `get_historic_flights_positions_light` 获取历史航班位置及基本信息。 *参数同上* #### `get_historic_flights_count` 获取历史航班数量。 *参数同上* ### 航班摘要 #### `get_flight_summary_full` 获取全面的航班起飞/降落信息。 **必选参数：** - `flight_datetime_from`：起始日期时间（YYYY-MM-DDTHH:MM:SSZ） - `flight_datetime_to`：结束日期时间（YYYY-MM-DDTHH:MM:SSZ） **可选参数：** - `flights`, `callsigns`, `registrations`, `airports`, `routes`, `aircraft` - `sort`：排序顺序（"asc" 或 "desc"） - `limit`：最大结果数（最大：20000） #### `get_flight_summary_light` 获取基本的航班起飞/降落信息。 *参数同上* #### `get_flight_summary_count` 获取摘要查询中的航班数量。 *参数同上（不含 sort/limit）* ### 特定航班数据 #### `get_flight_tracks` 获取特定航班的详细位置航迹。 **必选参数：** - `flight_id`：Flightradar24 航班 ID（十六进制） ### 参考数据 #### `get_airline_info` 按 ICAO 代码获取航空公司信息。 **必选参数：** - `icao`：航空公司 ICAO 代码 #### `get_airport_info_light` 获取基本的机场信息。 **必选参数：** - `code`：机场 IATA 或 ICAO 代码 #### `get_airport_info_full` 获取包括位置、海拔、时区在内的全面机场信息。 **必选参数：** - `code`：机场 IATA 或 ICAO 代码 ## 使用示例 ### 查找纽约附近的航班 ``` Get live flights in the New York area with bounds: 41.0,-74.5,40.5,-73.5 ``` ### 追踪特定航班 ``` Get flight tracks for flight ID: 2f4a8b3c ``` ### 历史数据 ``` Get historical flights at JFK airport on timestamp 1640995200 with airports: inbound:JFK ``` ### 航班摘要 ``` Get flight summary from 2024-01-01T00:00:00Z to 2024-01-02T00:00:00Z for route JFK-LAX ``` ## 开发 ### 从源码构建 ``` git clone https://github.com/flightradar24/fr24api-mcp.git cd fr24api-mcp npm install npm run build ``` ## 支持 - **文档**：[https://fr24api.flightradar24.com](https://fr24api.flightradar24.com) - **问题**：[GitHub Issues](https://github.com/Flightradar24/fr24api-mcp/issues) - **API 支持**：联系 Flightradar24 API 支持 ## 许可证 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件。 ## 更新日志 ### 1.0.2 - fix：航班摘要 14 天提示词 - 更新发布文件以确保受信任发布者生效 (#6) ### 1.0.1 发布到 [MCP Registry](https://github.com/modelcontextprotocol/registry) ### 1.0.0 - 首次公开发布 - 全面的航班数据访问 - 支持实时和历史数据 - 增强的参数验证 - 改进的错误处理

标签：AI辅助, GNU通用公共许可证, MCP, MITM代理, Node.js, 暗色界面, 自动化攻击, 航班追踪, 航空数据