Airlabs Mcp Server

AirLabs MCP サーバー

このModel Context Protocol（MCP）サーバーを使うと、AirLabsの航空データ API にアクセスできます。Claude Desktop や Cursor などの AI アシスタントが、自然言語で質問するだけで、リアルタイムのフライトデータ、空港のスケジュール、遅延情報、航空会社・空港・航空機の機材・航路に関する参照データベースを直接利用できます。

サーバー全体は単一のファイル（index.ts）に収められています。ツール定義、AirLabs の HTTP クライアント、リクエスト処理、stdio トランスポートが含まれます。

機能

• リアルタイムのフライト状況 — フライト番号で検索し、状況、搭乗ゲート、ターミナル、遅延を確認できます。
• 空港スケジュール — 任意の空港の出発・到着便一覧を確認できます。
• 遅延の監視 — 空港または航空会社で、指定したしきい値を超えて遅延しているフライトを検索できます。
• リアルタイムの位置情報 — エリア、航空会社、登録番号で、航空機の現在の座標、高度、速度、進行方向を確認できます。
• 最寄りの空港 — 任意の座標から最も近い空港を検索できます。
• 参照データベース — 航空会社、空港、航空機の機材（登録番号または ICAO24 の 16 進数コードで検索）、航路ネットワークを参照できます。
• コードの解決 — 地名または航空会社名を IATA／ICAO コードに変換できます。

前提条件

1. Node.js 18.0.0 以降。
2. AirLabs API キー — https://airlabs.co/signup で無料キーを取得してください。

インストール

npm 経由

npm install -g @airlabs-co/airlabs-mcp

設定

Claude Desktop との連携

claude_desktop_config.json に次の内容を追加します。

{
  "mcpServers": {
    "airlabs": {
      "command": "npx",
      "args": ["@airlabs-co/airlabs-mcp@latest"],
      "env": {
        "AIRLABS_API_KEY": "your_api_key_here"
      }
    }
  }
}

メモ：

• your_api_key_here を実際の AirLabs API キーに置き換えてください。
• 設定を編集した後、Claude Desktop を再起動してください。
• ローカルでソースからビルドする場合は、"command": "node", "args": ["/path/to/build/index.js"] を使用してください。

その他の MCP クライアント

stdio 経由でサーバーを直接実行します。

AIRLABS_API_KEY=your_api_key_here npx @airlabs/airlabs-mcp

利用可能なツール

ツール	AirLabs エンドポイント	用途
get_flight_status	/flight	IATA／ICAO 番号による、1 便のリアルタイムの状況
get_airport_schedule	/schedules	空港の出発・到着便一覧
monitor_delays	/delays	指定したしきい値を超えて遅延しているフライト
track_live_flights	/flights	エリア、航空会社、登録番号による航空機のリアルタイム位置情報
find_nearest_airport	/nearby	座標から最も近い空港
search_airport_code	/suggest	名前を IATA／ICAO コードに変換
get_airline_info	/airlines	コードによる航空会社の詳細情報
get_airport_info	/airports	コードによる空港の詳細情報
lookup_aircraft	/fleets	登録番号または ICAO24 の 16 進数コードによる航空機の検索
find_routes	/routes	指定した航路を運航する航空会社

すべてのツールでは、エンドポイントが対応している場合、任意の _fields パラメーターを指定して選択したフィールドのみを返し、応答を簡潔にできます。

使用例

設定が完了したら、アシスタントに次のように尋ねるだけです。

• 「BA117 便は定刻ですか？」 → get_flight_status
• 「今日、JFK を出発するフライトは何ですか？」 → get_airport_schedule
• 「LAX の到着便に 30 分を超える遅延はありますか？」 → monitor_delays
• 「ニューヨーク上空を飛行中の航空機を表示してください。」 → track_live_flights
• 「登録番号 N790AN の航空機は何ですか？」 → lookup_aircraft
• 「ロンドンから東京へ飛ぶ航空会社はどこですか？」 → find_routes

開発

ソースからのビルド

git clone https://github.com/airlabs-co/airlabs-mcp.git
cd airlabs-mcp
npm install
npm run build

コントリビューション

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. プルリクエストを送信します。

サポート

• ドキュメント：https://airlabs.co/docs
• 問題：GitHub の問題
• API サポート：https://airlabs.co/faq#Contact

ライセンス

MIT ライセンス — LICENSE を参照してください。