Aviationstack MCP

🚀 Aviationstack MCP Server

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

🚀 クイックスタート

このサーバーを使用することで、航空データを簡単に取得できます。まずは、必要な前提条件を用意し、利用可能なツールを使って航空データを取得しましょう。

✨ 主な機能

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

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

デモ

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

📦 インストール

前提条件

• 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 を参照してください。