FlightRadar MCP Server

FlightRadar MCP 服务

一个通过 AviationStack API 提供实时航班追踪和状态信息的模型上下文协议（MCP）服务。

功能

此 MCP 服务提供六种工具：

1. get_flight_data：通过航班的 IATA 或 ICAO 代码获取详细信息
2. search_flights：按航空公司、出发／到达机场和状态等条件搜索航班
3. get_flight_status：获取特定航班的易读状态摘要
4. search_airports：通过 IATA／ICAO 代码或机场名称查询机场参考数据（名称、位置、时区）
5. get_airline_info：通过 IATA／ICAO 代码或航空公司名称查询航空公司参考数据（名称、代码、机队信息）
6. get_future_flights：获取指定未来日期某机场计划起飞或到达的航班

工具 1-3 使用 AviationStack 的实时 /flights 端点，可在免费套餐中使用。工具 4-6 使用 /airports、/airlines 和 /flightsFuture 端点，需要付费的 AviationStack 套餐（Basic 或更高版本）；使用免费套餐密钥调用这些端点时，API 会返回 function_access_restricted 错误。

安装

通过 Smithery 安装

如需通过 Smithery 自动为 Claude Desktop 安装 flightradar-mcp-server：

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

前提条件

• Node.js（v14 或更高版本）
• npm（v6 或更高版本）
• AviationStack API 密钥（可在 aviationstack.com 获取）

设置

1. 克隆此代码仓库：

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

2. 安装依赖项：

   npm install
   

3. 构建服务：

   npm run build
   

4. 在 MCP 设置文件中配置服务：

   对于 Claude VSCode 扩展，将以下内容添加到 ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json：

   {
     "mcpServers": {
       "flightradar": {
         "command": "node",
         "args": ["/path/to/flightradar-mcp-server/build/index.js"],
         "env": {
           "AVIATIONSTACK_API_KEY": "YOUR_API_KEY_HERE"
         },
         "disabled": false,
         "autoApprove": []
       }
     }
   }
   

   对于 Claude 桌面应用，将配置添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或其他平台上的类似路径。

使用示例

配置好服务后，你可以使用 Claude 获取航班信息：

获取航班状态

User: What's the status of flight BA855?

Claude: Flight BA855 (British Airways) is currently landed.

Departure: Prague Vaclav Havel Airport (PRG), Terminal 1, Gate B5
Scheduled: 3/25/2025, 11:50:00 AM
Estimated: 3/25/2025, 11:50:00 AM

Arrival: Heathrow (LHR), Terminal 3
Scheduled: 3/25/2025, 1:10:00 PM

搜索航班

User: Find British Airways flights

Claude: I found 3212 British Airways flights. Here are the first 3:

1. BA5719: Tucson (TUS) to Dallas/Fort Worth (DFW)
   Status: scheduled
   Departure: 3/25/2025, 5:00:00 AM

2. BA6096: Prague (PRG) to Helsinki (HEL)
   Status: scheduled
   Departure: 3/25/2025, 11:40:00 AM

3. BA855: Prague (PRG) to London Heathrow (LHR)
   Status: landed
   Departure: 3/25/2025, 10:50:00 AM

获取航班详情

User: Get detailed information about flight BA855

Claude: Here are the details for flight BA855:

Flight: BA855 (BAW855)
Airline: British Airways
Aircraft: Airbus A320 (Registration: G-EUUH)

Departure:
- Airport: Prague Vaclav Havel Airport (PRG/LKPR)
- Terminal: 1, Gate: B5
- Scheduled: 3/25/2025, 10:50:00 AM

Arrival:
- Airport: London Heathrow (LHR/EGLL)
- Terminal: 3
- Scheduled: 3/25/2025, 12:10:00 PM

Status: landed

搜索机场

User: What airport is LHR?

Claude: LHR is London Heathrow Airport, London, United Kingdom (ICAO: EGLL, timezone: Europe/London).

获取航空公司信息

User: Which airline is BA?

Claude: BA is British Airways (ICAO: BAW, callsign: SPEEDBIRD), based in the United Kingdom.

获取未来航班

User: What flights are scheduled to depart JFK on 2027-03-01?

Claude: Here are scheduled departures from JFK on 2027-03-01:

1. AA100 to LHR, scheduled 2027-03-01T19:00:00
2. DL1 to CDG, scheduled 2027-03-01T20:30:00

API 密钥配置

此服务需要 AviationStack API 密钥才能运行。你可以在 aviationstack.com 获取免费 API 密钥（每月 100 次请求）。

应在 MCP 设置配置中将 API 密钥设为名为 AVIATIONSTACK_API_KEY 的环境变量。

注意：免费套餐仅支持实时航班查询（get_flight_data、search_flights、get_flight_status）。参考数据工具（search_airports、get_airline_info、get_future_flights）会调用需要付费套餐（Basic 或更高版本）的 AviationStack 端点；使用免费套餐密钥时，这些工具会返回 API 错误（function_access_restricted）。

许可证

MIT