Aviationstack 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 包管理器

💻 使用示例

可用工具

📚 詳細文檔

開發

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

MCP 服務器配置

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

1. 使用 uvx 而不克隆倉庫（推薦）

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

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

{
  "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>"
      }
    }
  }
}

📄 許可證

本項目採用 MIT 許可證。詳情請參閱 LICENSE 文件。