🚀 飞行雷达 MCP 服务器
飞行雷达 MCP 服务器基于 Model Context Protocol (MCP)，借助 AviationStack API 提供实时飞行跟踪和状态信息，让你轻松掌握航班动态。
🚀 快速开始
本服务器可帮助你获取航班数据、搜索航班以及获取航班状态，为你的航班查询提供便利。
✨ 主要特性
此 MCP 服务器提供三个主要功能：
- 获取航班数据：通过 IATA 或 ICAO 代码获取特定航班的详细信息。
- 搜索航班：按航空公司、起飞/到达机场和状态等多种标准搜索航班。
- 获取航班状态：为特定航班生成易于理解的状态摘要。
📦 安装指南
通过 Smithery 安装
要自动通过 Smithery 安装 flightradar - mcp - server（适用于 Claude Desktop），可使用以下命令：
npx -y @smithery/cli install @Cyreslab-AI/flightradar-mcp-server --client claude
先决条件
- Node.js (v14 或更高版本)
- npm (v6 或更高版本)
- 一个 AviationStack API 密钥（在 aviationstack.com 获取）
设置
- 克隆此仓库：
git clone https://github.com/Cyreslab-AI/flightradar-mcp-server.git
cd flightradar-mcp-server
- 安装依赖项：
npm install
- 构建服务器：
npm run build
- 在您的 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 桌面应用程序，添加到您的 MCP 设置配置中。
💻 使用示例
基础用法
获取航班数据
通过 IATA 或 ICAO 代码获取特定航班的详细信息：
GET /api/flight/{iata_or_icao}
请求参数：
iata_or_icao：IATA 或 ICAO 代码（例如，"LAX" 或 "KLAX"）
响应示例：
{
"data": {
"flight_number": "AA123",
"airline": "American Airlines",
"source_airport": "LAX",
"destination_airport": "JFK",
"departure_time": "2024-01-01T10:00:00Z",
"arrival_time": "2024-01-01T13:00:00Z",
"status": "on time"
}
}
搜索航班
按多种标准搜索航班：
GET /api/search
请求参数：
airline：航空公司名称（可选）source：起飞机场代码（可选）destination：到达机场代码（可选）date：日期（可选）
响应示例：
{
"data": [
{
"flight_number": "AA123",
"airline": "American Airlines",
"source_airport": "LAX",
"destination_airport": "JFK",
"departure_time": "2024-01-01T10:00:00Z",
"arrival_time": "2024-01-01T13:00:00Z",
"status": "on time"
},
{
"flight_number": "UA456",
"airline": "United Airlines",
"source_airport": "SFO",
"destination_airport": "ORD",
"departure_time": "2024-01-01T11:00:00Z",
"arrival_time": "2024-01-01T14:00:00Z",
"status": "delayed"
}
]
}
获取航班状态
为特定航班生成易于理解的状态摘要：
GET /api/status/{iata_or_icao}
请求参数：
iata_or_icao：IATA 或 ICAO 代码（例如，"LAX" 或 "KLAX"）
响应示例：
{
"data": {
"flight_number": "AA123",
"airline": "American Airlines",
"source_airport": "LAX",
"destination_airport": "JFK",
"departure_time": "2024-01-01T10:00:00Z",
"arrival_time": "2024-01-01T13:00:00Z",
"status": "on time"
}
}
📚 详细文档
API 密钥配置
此服务器需要一个 AviationStack API 密钥才能运行。您可以免费获取一个密钥（每月 100 次请求）在 aviationstack.com。
API 密钥应在 MCP 设置配置中作为环境变量提供，名为 AVIATIONSTACK_API_KEY。
📄 许可证
本项目采用 MIT 许可证。