Variflight MCP Server

Variflight MCP サーバー

VariFlight のフライト情報サービス向け Model Context Protocol（MCP）サーバー実装です。このサーバーでは、フライト情報、気象データ、フライトの快適性指標を問い合わせるさまざまなツールを提供します。

このパッケージは、VariFlight AI Open Platform における VariFlight Aviation MCP の stdio ディストリビューションです。クライアントのセットアップ、ツールのリファレンス、料金など、詳しいドキュメントはこちらをご覧ください：ai.variflight.com/docs/aviation (中文)。

Variflight API キー

Variflight MCP サーバーを利用するには、Variflight API キーが必要です。ai.variflight.com で登録し、コンソールから作成してください。新規アカウントには、試用クレジットとして ¥50 が付与されます。

リモートサーバー

同じツールをストリーミング可能な HTTP 経由のリモート MCP サーバーとして利用できるため、ローカルプロセスは不要です。

claude mcp add --transport http variflight-aviation https://ai.variflight.com/servers/aviation/mcp \
  --header "X-API-Key: YOUR_API_KEY"

OAuth 2.1 に対応したクライアントでは、キーを使わずに https://ai.variflight.com/servers/aviation/mcp を追加し、プロンプトが表示されたらサインインできます。

インストール

{
    "mcpServers": {
        "variflight": {
            "command": "npx",
            "args": [
                "-y",
                "@variflight-ai/variflight-mcp"
            ],
            "env": {
                "VARIFLIGHT_API_KEY": "your_api_key_here"
            }
        }
    }
}

利用可能なツール

1. 出発地と到着地によるフライト検索

指定した日付に、都市名または空港コードで直行便を検索します。BJS のような都市コード、または PEK のような正確な空港コードを使用してください。ただし、同じ側で都市コードと空港コードを混在させないでください。

searchFlightsByDepArr({
  dep: "PEK",  // Beijing
  arr: "SHA",  // Shanghai
  date: "2024-03-20"
})

2. 便名によるフライト検索

便名と日付を指定して、特定のフライトを検索します。

searchFlightsByNumber({
  fnum: "MU2157",
  date: "2024-03-20"
})

3. フライトの乗り継ぎ情報を取得

出発都市と到着都市の間の乗り継ぎ便の候補を検索します。

getFlightTransferInfo({
  depcity: "BJS",
  arrcity: "LAX",
  depdate: "2024-03-20"
})

searchFlightsByDepArr と getFlightTransferInfo では、任意のページネーションパラメーターも利用できます。利用者の多い路線では、項目数の多い結果が数十件返されることがあるため、以下を使って応答を小さくできます。

• limit：返す結果の最大数
• offset：スキップする結果の数。次のページを取得するには、前回の応答に含まれる next_offset を渡します。各ページは個別に課金されます。
• detail："summary" は各結果の主要な項目のみを返し、"full"（デフォルト）はすべての項目を返します。

いずれかを設定すると、応答には total、offset、returned が含まれます。さらに結果がある場合は、next_offset も含まれます。これらを指定しない場合、応答は変わりません。

searchFlightsByDepArr({
  depcity: "BJS",
  arrcity: "SHA",
  date: "2024-03-20",
  limit: 20,
  detail: "summary"
})

4. フライト快適度指数

定時運航率、機種、客室構成、食事、エンターテインメントなど、既知のフライトの快適性に関する詳細を取得します。

flightHappinessIndex({
  fnum: "MU2157",
  date: "2024-03-20"
})

5. 航空機のリアルタイム位置

航空機の登録番号（テールナンバーとも呼ばれます）を使用して、フライトのリアルタイム位置を追跡します。

getRealtimeLocationByAnum({
  anum: "B2021"
})

6. 空港の気象予報

空港の3日間の気象予報を取得します。

getFutureWeatherByAirport({
  airport: "PEK"
})

7. フライトの旅程を検索

おすすめのフライト候補、全体で最も安い料金、最短の所要時間、複数の旅程候補を自然言語で要約して取得します。

searchFlightItineraries({
  depCityCode: "BJS",  // Beijing
  arrCityCode: "SHA",  // Shanghai
  depDate: "2025-04-20"
})

8. 都市間のフライト料金を取得

2つの都市間の、構造化された生の販売フライトデータを取得します。各フライトについて、客室クラスごとの料金が返されます。

getFlightPriceByCities({
  dep_city: "BJS",  // Beijing
  arr_city: "SHA",  // Shanghai
  dep_date: "2026-04-20"
})

ライセンス

ISC License。詳細は LICENSE をご覧ください。

作者

Variflight (https://ai.variflight.com)

バージョン

現在のバージョン：1.1.0