Aviationstack MCP

該項目是一個基於AviationStack API的MCP服務器，提供即時和未來航班數據、飛機類型及詳細信息的查詢工具，便於集成航空數據到應用中。

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

評分 : 2.5分

下載量 : 4.1K

更新時間 : 2025-08-19

打開站點

什麼是Aviationstack MCP服務?

這是一個基於AviationStack航空數據API的模型交互協議服務器，可以讓您輕鬆查詢全球航班信息、飛機數據和機場時刻表。通過簡單的指令即可獲取專業航空數據，無需複雜編程。

如何使用本服務?

只需在支持MCP協議的客戶端中配置服務器地址和API密鑰，然後通過自然語言或結構化指令查詢所需航空數據。

適用場景

適用於旅行規劃應用開發、航班狀態監控系統、航空數據分析儀表板等需要即時或歷史航班數據的場景。

主要功能

航空公司航班查詢

按航空公司名稱獲取即時航班信息，包括航班號、起降時間和狀態

機場時刻表

查詢任意機場的到達/出發航班時刻表，支持按航空公司篩選

未來航班預測

獲取指定日期的計劃航班信息，支持提前規劃行程

飛機資料庫

隨機獲取各類飛機型號的詳細技術參數和圖片

地理數據

提供與航空相關的國家、城市詳細信息

優勢

即時數據來自專業航空數據提供商

無需複雜API集成，通過自然語言即可查詢

免費基礎版可用，適合個人開發者和小型項目

侷限性

免費版有API調用次數限制

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

依賴AviationStack服務的可用性

如何使用

獲取API密鑰

訪問AviationStack官網註冊免費賬戶獲取API密鑰

配置MCP客戶端

在MCP兼容客戶端中添加服務器配置

開始查詢

使用提供的工具名稱和參數發送查詢請求

使用案例

旅行行程規劃

查詢特定日期某機場的所有出發航班，用於規劃旅行路線

航班狀態監控

即時監控特定航空公司的航班延誤情況

常見問題

需要付費嗎？

數據更新頻率是多少？

支持哪些機場和航空公司？

🚀 Aviationstack MCP 服務器

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

🚀 快速開始

此項目可幫助你輕鬆集成航空數據到應用程序，以下是相關使用說明。你可以通過代碼或配置文件來使用本項目的功能。

演示

https://github.com/user-attachments/assets/9325fcce-8ecc-4b01-8923-4ccb2f6968f4

✨ 主要特性

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

所有端點均以 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 代碼（例如，Delta 的 "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>"
      }
    }
  }
}