Flight + Stay Search MCP (TypeScript)

Flight + Stay Search MCP（TypeScript）

Duffel API を使用してフライトを検索する、Flight & Stay Search MCP サーバーの TypeScript 実装です。この MCP サーバーは、片道、往復、複数都市間のフライトを検索するツールを提供します。

機能

• 片道、往復、複数都市間のフライトを検索します
• 特定のフライトオファーの詳細情報を取得します
• 客室クラス、乗客数、乗り継ぎの希望を指定します
• 出発時刻と到着時刻の範囲で絞り込みます
• 旅行先の宿泊施設（ホテル／宿泊施設）を検索します
• 特定の宿泊施設／ホテルの宿泊者レビューを取得します

セットアップ

1. 依存関係をインストールします：

   npm install
   

2. プロジェクトをビルドします：

   npm run build
   

3. サーバーを起動します：

   npm start
   

環境変数

以下の内容で .env ファイルを作成します：

DUFFEL_API_KEY=your_duffel_api_key

まずはテスト用 API キー（duffel_test）を使って機能を試すことができます。

Smithery での使用

この MCP を Smithery に公開するには：

npx @smithery/cli publish

公開した MCP を実行するには：

npx @smithery/cli run @your-username/flights-mcp-ts --config "{\"duffelApiKey\":\"your_duffel_api_key\"}"

利用可能なツール

この MCP は以下のツールを提供します：

1. search_flights - 片道、往復、または複数都市間のフライトを検索します
2. get_offer_details - 特定のフライトオファーの詳細情報を取得します
3. search_multi_city - 複数都市間のフライト検索に特化したツールです
4. search_stays - 旅行先の宿泊施設（ホテル／宿泊施設）を検索します
5. get_stay_reviews - 特定の宿泊施設／ホテルの宿泊者レビューを取得します

クエリの例

• 「2025年5月15日の SFO から NYC へのフライトを探してください」
• 「6月10日出発、6月20日帰着の LAX から LHR への往復フライトを検索してください」
• 「東京からパリへのビジネスクラスのフライトを大人2名分探してください」
• 「フライトオファー [offer_id] の詳細を取得してください」
• 「2025-06-10 から 2025-06-12 まで、宿泊者2名分のロンドンのホテルを探してください」
• 「宿泊施設 [hotel_id] のレビューを取得してください」

---

宿泊施設／ホテルの検索とレビュー

1. 宿泊施設を検索する（search_stays）

パラメーター：

• location（string）：宿泊施設を検索する都市、空港コード、または地域
• check_in_date（string）：チェックイン日（YYYY-MM-DD）
• check_out_date（string）：チェックアウト日（YYYY-MM-DD）
• guests（number）：宿泊者数
• rooms（number、任意）：部屋数
• radius_km（number、任意）：検索半径（キロメートル）

リクエストの例：

{
  "location": "London",
  "check_in_date": "2025-06-10",
  "check_out_date": "2025-06-12",
  "guests": 2
}

レスポンスの例：

{
  "offers": [
    {
      "offer_id": "off_123",
      "hotel_id": "acc_0000AWr2VsUNIF1Vl91xg0",
      "hotel_name": "The Grand Hotel",
      "address": "1 Main St, London",
      "price": { "amount": "350.00", "currency": "GBP" },
      "room_type": "Deluxe Suite",
      "cancellation_policy": "Free cancellation until 24h before check-in"
    }
  ]
}

注： 検索結果の hotel_id をレビュー取得時の stay_id として使用してください。

---

2. 宿泊施設のレビューを取得する（get_stay_reviews）

パラメーター：

• stay_id（string）：Duffel の宿泊施設／ホテルの一意の ID（search_stays の結果から取得）
• after（string、任意）：ページネーションカーソル（後）
• before（string、任意）：ページネーションカーソル（前）
• limit（number、任意）：取得するレビューの最大件数（1～200）

リクエストの例：

{
  "stay_id": "acc_0000AWr2VsUNIF1Vl91xg0"
}

レスポンスの例：

{
  "meta": { "limit": 50, "after": "..." },
  "reviews": [
    {
      "text": "Excellent facilities. Polite staff.\nAir conditioning could use some maintenance.\n",
      "score": 8.4,
      "reviewer_name": "Bessie Coleman",
      "created_at": "2025-01-01"
    }
  ]
}

ローカル開発

自動リロードを使って開発するには：

npm run dev

ライセンス

MIT