Aviationstack MCP

🚀 Aviationstack MCP Server

このプロジェクトは、AviationStack API とやり取りするための一連のツールを提供する MCP (Model Context Protocol) サーバー です。リアルタイムおよび将来のフライトデータ、航空機の種類、航空機の詳細を取得するためのエンドポイントを公開しており、航空データをアプリケーションに簡単に統合できるようになっています。

🚀 クイックスタート

このサーバーを使用することで、AviationStack API から様々な航空データを取得できます。以下の手順に従ってセットアップしてください。

✨ 主な機能

• 特定の航空会社のフライトを取得
• 空港の到着と出発スケジュールを取得
• 将来のフライトスケジュールを取得
• ランダムな航空機の種類を取得
• ランダムな航空機の詳細情報を取得
• ランダムな国の詳細情報を取得
• ランダムな都市の詳細情報を取得

すべてのエンドポイントは MCP ツールとして実装されており、MCP 互換環境で使用できます。

📦 インストール

前提条件

• Aviationstack API キー ( Aviationstack から無料の API キーを取得できます)
• Python 3.13 以上
• uv パッケージマネージャーがインストールされていること

💻 使用例

基本的な使用法

以下の手順でサーバーを設定し、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>"
      }
    }
  }
}

利用可能なツール

🔧 技術詳細

• メインのサーバーロジックは server.py にあります。
• すべての MCP ツールは @mcp.tool() で装飾された Python 関数として定義されています。
• サーバーは mcp.server.fastmcp の FastMCP クラスを使用しています。

📄 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE を参照してください。

デモ

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