Flightradar24 MCP Server 🛩️

Flightradar24 MCP 服务 🛩️

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

它能做什么？ ✨

• 🔍 实时追踪任意航班
• ⏰ 获取指定航班的到达和出发时间
• 🌉 查看机场航班状态
• 🚨 监控紧急航班

设置指南 🚀

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 配置文件：

   # On Mac:
   ~/Library/Application Support/Claude/claude_desktop_config.json
   
   # On 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. 在 .env 文件中填写你的 Flightradar24 API 密钥：

   FR24_API_KEY=your_actual_api_key_here
   

注意：切勿将实际 API 密钥提交到版本控制系统。出于安全考虑，.env 文件已被 git 忽略。

来试试看！ 🎮

配置好服务后，你可以向 Claude 提出以下问题：

1. “United Airlines 航班 UA123 的预计到达时间是什么时候？”
2. “显示目前所有位于 SFO 的航班”
3. “附近有紧急航班吗？”
4. “显示未来 2 小时内所有抵达 SFO 的国际航班”
5. “目前有多少商业航班正在太平洋上空飞行？”
6. “找出在加利福尼亚地区宣布紧急状态的航班”

与 Claude 的对话示例：

You: What's the status of flight UA123?
Claude: Let me check that for you...
[Claude will use the MCP server to fetch real-time flight information]

常见问题与故障排除 🤔

“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

---

为航空爱好者倾心打造 ❤️