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 文件。