JinDaGe - flightradar-mcp-server MCP Details

article

README

🚀 FlightRadar MCP 服务器

这是一个使用 AviationStack API 的模型上下文协议（MCP）服务器，它能提供实时飞行追踪和状态信息，让你随时掌握航班动态。

🚀 快速开始

本 FlightRadar MCP 服务器能为你提供便捷的航班信息查询服务，下面为你介绍它的各项功能、安装步骤和使用示例。

✨ 主要特性

此 MCP 服务器提供了三个主要工具：

get_flight_data：通过航班的 IATA 或 ICAO 代码获取详细的飞行信息。
search_flights：根据航空公司、出发/到达机场和状态等标准搜索航班。
get_flight_status：为特定航班获取人类可读的状态摘要。

📦 安装指南

通过 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 获取）

设置

克隆此仓库：

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": [],
      "env": {},
      "prependEnv": true,
      "appendEnv": true,
      "cwd": "/path/to/flightradar-mcp-server",
      "name": "FlightRadar"
    }
  }
}

请确保将 /path/to/flightradar-mcp-server 替换为实际路径。

💻 使用示例

基础用法

获取航班信息

curl --location 'http://localhost:3000/api/v1/flight' \
--header 'Content-Type: application/json' \
--data-raw '{
    "operation": "get_flight_data",
    "args": {
        "flight_number": "LH297"
    }
}'

搜索航班

curl --location 'http://localhost:3000/api/v1/flight' \
--header 'Content-Type: application/json' \
--data-raw '{
    "operation": "search_flights",
    "args": {
        "airport": "SFO"
    }
}'

获取航班状态

curl --location 'http://localhost:3000/api/v1/flight' \
--header 'Content-Type: application/json' \
--data-raw '{
    "operation": "get_flight_status",
    "args": {
        "flight_number": "DL456"
    }
}'

📚 详细文档

API 密钥配置

此服务器需要 AviationStack API 密钥才能运行。您可以在 aviationstack.com 免费获取一个密钥（每月 100 次请求）。 API 密钥应作为名为 AVIATIONSTACK_API_KEY 的环境变量提供到您的 MCP 设置配置中。

📄 许可证

本项目采用 MIT 许可证。

flightradar-mcp-server