航空堆栈-MCP

Aviationstack MCP Server

该项目是一个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”）<br> - 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”）<br> - schedule_type: “arrival” 或 “departure”<br> - airline_name: 航空公司名称<br> - 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代码<br> - schedule_type: “arrival” 或 “departure”<br> - airline_iata: 航空公司的IATA代码（例如，“DL”代表Delta）<br> - date: 格式为YYYY-MM-DD的日期<br> - 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客户端配置文件中添加以下内容。

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_m_ cp",
        "mcp",
        "run"
      ],
      "env": {
        "AVIATION_STACK_API_KEY": "<your-api-key>"
      }
    }
  }
}

许可证

本项目采用MIT许可证。详情见LICENSE。