Aviationstack MCP

探索

Aviationstack MCP

Aviationstack MCP服務器是一個基於Model Context Protocol的服務，提供與AviationStack API交互的工具，可獲取即時航班、未來航班、飛機類型等航空數據。

旅行與交通研究與數據 #航空數據 #航班查詢 #API服務 .Python

評分 : 2.5分

下載量 : 6.9K

更新時間 : 2025-07-31

打開站點

什麼是Aviationstack MCP?

這是一個基於AviationStack API的模型上下文協議(MCP)服務器，專門用於獲取全球航班和航空相關數據。它通過簡單的接口提供即時航班信息、機場時刻表、飛機詳情等數據。

如何使用Aviationstack MCP?

您需要先獲取AviationStack API密鑰，然後通過MCP客戶端配置連接到本服務器。服務器提供多種查詢工具，如查詢特定航空公司的航班、機場起降時刻等。

適用場景

適用於需要集成航班數據的應用程序開發、旅行規劃系統、航空數據分析等場景。

主要功能

航空公司航班查詢

獲取指定航空公司的即時航班信息

機場時刻表

查詢機場的到達和出發航班時刻表

未來航班查詢

獲取未來某日期的航班計劃信息

飛機信息

獲取隨機飛機型號和詳細信息

地理位置信息

獲取隨機國家和城市的信息

優勢

即時航班數據更新

支持多種查詢方式

簡單的MCP接口集成

免費基礎API訪問

侷限性

免費版API有調用限制

需要網絡連接

部分高級功能需要付費訂閱

如何使用

獲取API密鑰

從Aviationstack官網註冊並獲取免費API密鑰

配置MCP客戶端

在您的MCP客戶端中添加服務器配置

開始查詢

使用提供的工具函數查詢所需航班信息

使用案例

查詢航空公司航班

獲取達美航空的5個航班信息

查詢機場到達航班

獲取JFK機場未來3天的到達航班

常見問題

如何獲取API密鑰?

免費版有什麼限制?

如何提高查詢速度?

🚀 Aviationstack MCP 服務器

本項目是一個 MCP（模型上下文協議）服務器，它提供了一套工具，用於與 AviationStack API 進行交互。該服務器公開了用於檢索即時和未來航班數據、飛機類型以及飛機詳細信息的端點，使您能夠輕鬆地將航空數據集成到自己的應用程序中。

🚀 快速開始

本項目是一個 MCP 服務器，可通過特定端點與 AviationStack API 交互，從而獲取航空相關數據。您可以按照以下步驟進行配置，將其集成到您的應用程序中。

✨ 主要特性

獲取特定航空公司的航班信息
檢索機場的到達和出發時刻表
獲取未來航班時刻表
獲取隨機飛機類型
獲取隨機飛機的詳細信息
獲取隨機國家的詳細信息
獲取隨機城市的詳細信息

所有端點均以 MCP 工具的形式實現，可在兼容 MCP 的環境中直接使用。

📦 安裝指南

前提條件

Aviationstack API 密鑰（您可以從 Aviationstack 獲取免費的 API 密鑰）
Python 3.13 或更高版本
已安裝 uv 包管理器

💻 使用示例

可用工具

屬性	詳情
工具	描述
參數	說明

工具	描述	參數
`flights_with_airline(airline_name: str, number_of_flights: int)`	獲取特定航空公司的隨機航班樣本。	- `airline_name`：航空公司名稱（例如，"Delta Air Lines"） - `number_of_flights`：要返回的航班數量
`flight_arrival_departure_schedule(airport_iata_code: str, schedule_type: str, airline_name: str, number_of_flights: int)`	獲取給定機場和航空公司的到達或出發時刻表。	- `airport_iata_code`：機場的 IATA 代碼（例如，"JFK"） - `schedule_type`："arrival" 或 "departure" - `airline_name`：航空公司名稱 - `number_of_flights`：要返回的航班數量
`future_flights_arrival_departure_schedule(airport_iata_code: str, schedule_type: str, airline_iata: str, date: str, number_of_flights: int)`	獲取給定機場、航空公司和日期的未來航班時刻表。	- `airport_iata_code`：機場的 IATA 代碼 - `schedule_type`："arrival" 或 "departure" - `airline_iata`：航空公司的 IATA 代碼（例如，"DL" 代表達美航空） - `date`：格式為 `YYYY-MM-DD` 的日期 - `number_of_flights`：要返回的航班數量
`random_aircraft_type(number_of_aircraft: int)`	獲取隨機飛機類型。	- `number_of_aircraft`：要返回的飛機類型數量
`random_airplanes_detailed_info(number_of_airplanes: int)`	獲取隨機飛機的詳細信息。	- `number_of_airplanes`：要返回的飛機數量
`random_countries_detailed_info(number_of_countries: int)`	獲取隨機國家的詳細信息。	- `number_of_countries`：要返回的國家數量
`random_cities_detailed_info(number_of_cities: int)`	獲取隨機城市的詳細信息。	- `number_of_cities`：要返回的城市數量

🔧 技術細節

開發

主要的服務器邏輯位於 server.py 文件中。
所有 MCP 工具都定義為使用 @mcp.tool() 裝飾的 Python 函數。
服務器使用 mcp.server.fastmcp 中的 FastMCP 類。

MCP 服務器配置

要將此服務器添加到您喜歡的 MCP 客戶端中，您可以將以下內容添加到 MCP 客戶端配置文件中。

基礎用法

使用 uvx 且不克隆倉庫（推薦）

{
  "mcpServers": {
    "Aviationstack MCP": {
      "command": "uvx",
      "args": [
        "aviationstack-mcp"
      ],
      "env": {
        "AVIATION_STACK_API_KEY": "<your-api-key>"
      }
    }
  }
}

高級用法

通過克隆倉庫並在本地運行服務器

{
  "mcpServers": {
    "Aviationstack MCP": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/aviationstack-mcp/src/aviationstack_mcp",
        "run",
        "-m",
        "aviationstack_mcp",
        "mcp",
        "run"
      ],
      "env": {
        "AVIATION_STACK_API_KEY": "<your-api-key>"
      }
    }
  }
}