Flightradar24 MCP 服务器 🛩️

一个 Claude Desktop MCP 服务器，可以帮助你使用 Flightradar24 数据实时追踪航班。非常适合航空爱好者、旅行规划者或任何对头顶航班感到好奇的人！

功能特性 ✨

• 🔍 实时追踪任何航班
• ⏰ 获取特定航班的到达和起飞时间
• 🌉 查看机场的航班状态
• 🚨 监控紧急航班

<img width="1466" alt="Anthropic Claude MCP Hackathon - FlightRadar24 MCP server" src="https://github.com/user-attachments/assets/719444ae-2c8b-4441-84f8-5150337d871f" />

设置指南 🚀

1. 前提条件

• 你的电脑上已安装 Claude Desktop
• 一个 Flightradar24 API 密钥（从 Flightradar24 网站 获取）*

2. 安装

1. 将此仓库克隆到你电脑上的某个位置：

   git clone https://github.com/sunsetcoder/flightradar24-mcp-server.git
   

2. 安装依赖项并构建项目：

   cd flightradar24-mcp-server
   npm install
   npm run build
   

3. 与 Claude Desktop 集成

1. 打开你的 Claude Desktop 配置文件：

   # 在 Mac 上：
   ~/Library/Application Support/Claude/claude_desktop_config.json
   
   # 在 Windows 上：
   %APPDATA%/Claude/claude_desktop_config.json
   

2. 将以下内容添加到你的配置中的 mcpServers 对象：

   {
     "mcpServers": {
       "flightradar24-server": {
         "command": "node",
         "args": [
           "/Users/<username>/<FULL_PATH...>/flightradar24-mcp-server/dist/index.js"
         ],
         "env": {
           "FR24_API_KEY": "your_api_key_here",
           "FR24_API_URL": "https://fr24api.flightradar24.com"
         }
       }
     }
   }
   

3. 重要步骤：

   • 将 /FULL/PATH/TO/flightradar24-mcp-server 替换为你克隆仓库的实际完整路径
   • 在 env 部分添加你的 Flightradar24 API 密钥
   • 确保在路径中使用正斜杠 (/)，即使在 Windows 上也是如此

4. 重启 Claude Desktop 以使更改生效

环境变量设置

1. 将 .env.example 复制到 .env：

   cp .env.example .env
   

2. 使用你实际的 Flightradar24 API 密钥更新 .env 文件：

   FR24_API_KEY=your_actual_api_key_here
   

注意：永远不要将你实际的 API 密钥提交到版本控制。出于安全原因，.env 文件会被 git 忽略。

让我们试一试！ 🎮

服务器配置完成后，你可以向 Claude 提出如下问题：

1. "美国联合航空 UA123 航班的预计到达时间是什么时候？"
2. "显示目前在 SFO 的所有航班"
3. "该区域是否有任何紧急航班？"
4. "显示未来 2 小时内抵达 SFO 的所有国际航班"
5. "目前有多少商业航班飞越太平洋？"
6. "识别加利福尼亚地区宣布紧急情况的任何航班"

与 Claude 的对话示例：

你：UA123 航班的状态是什么？
Claude：让我为你查一下...
[Claude 将使用 MCP 服务器获取实时航班信息]

常见问题和故障排除 🤔

"Claude 无法连接到服务器"

• 检查 claude_desktop_config.json 中的路径是否正确
• 确保你使用的是完整的绝对路径
• 验证你的 API 密钥是否正确
• 尝试重启 Claude Desktop

"服务器没有响应"

• 确保你的 Flightradar24 API 密钥有效
• 检查 API URL 是否正确
• 在服务器日志中查找任何错误消息

FlightRadar API 访问

• 注意：使用 Flightradar24 的 API 需要 订阅

需要更多帮助？ 🆘

1. 确保 Claude Desktop 已正确安装
2. 验证你的 Flightradar24 API 密钥是否已激活
3. 检查你的配置文件中的路径是否正确
4. 在 MCP 服务器日志中查找错误消息

许可证 📄

MIT

---

用 ❤️ 为航空爱好者制作