🌍 Travel Assistant MCP Server Ecosystem

🌍 Travel Assistant MCP サーバーエコシステム

旅行の計画とサポートをインテリジェントに提供するため、連携して動作する Model Context Protocol（MCP）サーバーの包括的なスイートです。このエコシステムでは、Claude が複数の専門サービスを統合し、詳細な旅行日程の作成、最適な航空便や宿泊施設の検索、現地イベントの発見、気象条件の分析、異なる通貨での予算管理を行えます。

🎯 システム概要

Travel Assistant MCP エコシステムは、連携して動作する6つの専門サーバーで構成されています。

• 🛫 フライト検索サーバー - 航空便の検索と比較、価格の分析、希望条件による絞り込み
• 🏨 ホテル検索サーバー - 宿泊施設の検索、設備の比較、予算や希望条件による絞り込み
• 🎭 イベント検索サーバー - 現地のイベント、フェスティバル、アクティビティの検索
• 🗺️ ジオコーダーサーバー - 場所を座標に変換、距離の計算、逆ジオコーディング
• 🌤️ 天気検索サーバー - 天気予報、現在の気象状況、気象警報の取得
• 💰 金融検索サーバー - 通貨換算、為替レート、金融分析

🚀 実例：LLM を使った包括的な旅行プランのオーケストレーション

ユーザーのリクエスト：「2025年6月7日から6月14日まで、バージニア州レストンからアルバータ州のバンフとジャスパーへ旅行する予定です。航空便、ホテル、アルバータ州バンフで開催されるイベントと、天気に応じた私と妻のためのアクティビティを探してください。ハイキング、観光、食事、美術館巡りが好きです。予算は5,000米ドルです。提示する前に、カナダドルから米ドルに換算してください。」

🎼 オーケストレーションされた応答の流れ

この複雑なリクエストに応えるため、Claude が MCP サーバーをどのようにオーケストレーションするかを説明します。

ステップ1：位置情報の把握 🗺️

• ジオコーダーサーバーを使用して、「Reston, Virginia」、「Banff, Alberta」、「Jasper, Alberta」を緯度・経度の座標に変換します。
• 旅行日程を計画するため、場所間の距離を計算します。

ステップ2：航空便の検索 ✈️

• フライトサーバーを使用して、指定された日程で、バージニア州レストンに最も近い空港（例：IAD）から、バンフ／ジャスパーに最も近いアルバータ州カルガリーまでの航空便を検索します。
• 価格、所要時間、希望する航空会社で絞り込みます。
• 乗り継ぎ、手荷物規定、合計費用など、航空便の詳細情報を取得します。

ステップ3：宿泊施設の検索 🏨

• ホテルサーバーを使用して、旅行日程に合わせてバンフとジャスパーのホテルやバケーションレンタルを探します。
• 価格、設備（無料 WiFi、朝食など）、宿泊客の評価で絞り込みます。
• 宿泊施設の詳細情報を取得し、有力な候補を比較して、宿泊費の合計を分析します。

ステップ4：気象分析 🌤️

• 天気サーバーを使用して、バンフとジャスパーの日別／時間別の天気予報を取得します。
• 屋外アクティビティに適した天候かどうかを評価し、ハイキングや観光に最適な日を提案します。

ステップ5：イベントとアクティビティの検索 🎭

• イベントサーバーを使用して、旅行中にバンフとジャスパーで開催される現地のイベント、フェスティバル、アクティビティを探します。
• 関心のある内容（ハイキング、観光、食事、美術館）で絞り込みます。

ステップ6：財務分析 💰

• 金融サーバーを使用して、ホテルやイベントなどのすべての費用をカナダドルから米ドルに換算します。
• プランの総額が5,000米ドルの予算内に収まるようにします。

ステップ 7：インテリジェントな統合 🧠

Claude はすべてのデータを統合して、次の情報を作成します：

• 価格を比較した最適なフライトの選択肢
• 好みや予算に合った厳選ホテルのおすすめ
• 天候に適したアクティビティのスケジュール
• 天候に応じた代替案を含む日ごとの旅程
• 通貨換算を含む米ドルでの詳細な予算内訳
• 各場所間の距離と移動時間の計算
• 日ごとの旅程を提示し、天候や興味に基づいてアクティビティをおすすめし、米ドルでの予算内訳を提供します。

🎯 MCP でこれが実現する理由

サーバー間の統合

• 統一されたプロトコル：すべてのサーバーが同じ MCP 仕様を使用するため、シームレスに通信できます
• 標準化されたデータ形式：異なる分野間で一貫した JSON 構造を使用します
• 共有コンテキスト：Claude は複数のサーバーとのやり取りを通じて会話の状態を維持します

インテリジェントな順序制御

• 依存関係の管理：Claude は、天気予報を取得する前にジオコーディングが必要であることを理解します
• 条件ロジック：フライト検索を契機に、目的地の都市でホテル検索を行います
• エラー処理：サーバーの1つに障害が発生した場合、Claude は順序を動的に調整できます

リアルタイム処理

• 並列実行：依存関係に問題がない場合、複数のサーバーに同時に問い合わせできます
• ライブデータ：すべてのサーバーがリアルタイム情報（フライト、天気、イベント、為替レート）を提供します
• 動的なフィルタリング：あるサーバーの結果を別のサーバーのパラメーターに反映します

データの統合

• 複数分野の分析：天気データをイベントのスケジュールやアクティビティのおすすめと組み合わせます
• 予算の最適化：通貨換算により、海外旅行中の予算を正確に管理できます
• 好みに合わせた絞り込み：申告された興味（ハイキング、美術館、食事など）に基づいてアクティビティを絞り込みます

サーバー機能の概要

サーバー	主なツール／リソース／プロンプト	使用例
フライト	search_flights, get_flight_details, filter_flights_by_price	フライトを検索・比較し、選択肢を分析する
ホテル	search_hotels, get_hotel_details, filter_hotels_by_price	ホテル／宿泊施設を検索し、設備で絞り込み、比較する
イベント	search_events, get_event_details, filter_events_by_date	地域のイベントを見つけ、種類や日付で絞り込む
天気	get_weather_forecast, get_current_conditions, filter_forecast_by_conditions	天気に基づいてアクティビティを計画し、警報を取得する
ジオコーダー	geocode_location, reverse_geocode, calculate_distance	住所を変換し、ルートを計画して、距離を計算する
金融	convert_currency, lookup_stock, get_market_overview	費用を換算し、予算を分析して、市場データを取得する

---

🛠️ インストール完全ガイド

前提条件

• Python 3.8 以降
• UV パッケージマネージャー
• Claude Desktop アプリケーション
• 必要なサービスの API キー

必要な API キー

• SerpAPI キー（フライト、ホテル、イベント用）- 無料キーを取得
• OpenWeatherMap または National Weather Service（無料）
• OpenStreetMap Nominatim（無料、キー不要）

セットアップ手順

1. プロジェクトディレクトリを作成：

mkdir travel-assistant-mcp
cd travel-assistant-mcp

2. すべてのサーバーリポジトリをクローン：

# Create subdirectories for each server
mkdir flight-search hotel-search event-search geocoder weather-search finance-search

3. 各サーバーの依存関係をインストール：

# In each server directory
uv sync

4. Claude Desktop を設定：

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します：

{
  "mcpServers": {
    "flight-search": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/travel-assistant-mcp/flight-search",
        "run", "python", "flight_search_server.py"
      ],
      "env": {
        "SERPAPI_KEY": "your_serpapi_key"
      }
    },
    "hotel-search": {
      "command": "uv", 
      "args": [
        "--directory", "/path/to/travel-assistant-mcp/hotel-search",
        "run", "python", "hotel_search_server.py"
      ],
      "env": {
        "SERPAPI_KEY": "your_serpapi_key"
      }
    },
    "event-search": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/travel-assistant-mcp/event-search", 
        "run", "python", "event_search_server.py"
      ],
      "env": {
        "SERPAPI_KEY": "your_serpapi_key"
      }
    },
    "geocoder": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/travel-assistant-mcp/geocoder",
        "run", "python", "geocoder_server.py" 
      ]
    },
    "weather-search": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/travel-assistant-mcp/weather-search",
        "run", "python", "weather_search_server.py"
      ]
    },
    "finance-search": {
      "command": "uv", 
      "args": [
        "--directory", "/path/to/travel-assistant-mcp/finance-search",
        "run", "python", "finance_search_server.py"
      ],
      "env": {
        "SERPAPI_KEY": "your_serpapi_key"
      }
    }
  }
}

5. すべてのサーバーを読み込むため、Claude Desktop を再起動します。

💡 高度な使用例

週末旅行の計画

Plan a weekend trip from San Francisco to Portland, Oregon for next weekend. 
We want to visit breweries, food trucks, and outdoor markets. Budget is $1500 
for 2 people. Find flights leaving Friday evening and returning Sunday night.

海外出張

I need to travel from New York to Tokyo for a conference June 20-25, 2025. 
Find business class flights, luxury hotels near Tokyo Station, check weather 
for appropriate clothing, and convert all costs to USD. Also find networking 
events for tech professionals during that week.

家族旅行の計画

Plan a family vacation to Orlando, Florida for July 15-22, 2025 for 2 adults 
and 2 children (ages 8 and 12). We want to visit theme parks, but also need 
backup indoor activities in case of rain. Budget is $8000 USD total.

複数都市を巡るヨーロッパ旅行

Plan a 2-week European tour visiting London, Paris, Rome, and Barcelona 
from August 5-19, 2025. Find the most efficient flight routing, centrally 
located hotels, cultural events and museums, check weather patterns, 
and provide a day-by-day itinerary with budget breakdown.

🏗️ アーキテクチャのメリット

モジュール性

• 各サーバーが特定の分野を専門的に担当します
• サーバーを個別に更新できます
• 新しい機能（レンタカー、レストランの予約など）を簡単に追加できます

スケーラビリティ

• サーバーを異なるシステムに分散できます
• トラフィックが多い場合は負荷分散が可能です
• 個々のサーバーに障害が発生しても、システム全体が停止することはありません

データプライバシー

• 一元的なデータ保存は不要です
• 各サーバーが独自のデータ保持ポリシーを管理します
• ユーザーは有効にするサーバーを選択できます

拡張性

• 旅行関連の新しいサーバーを簡単に追加できます
• サーバーごとにカスタムのビジネスロジックを実装できます
• 企業向け旅行管理システムとの連携も可能です

🔧 トラブルシューティングガイド

よくある連携の問題

サーバー間で通信できない場合：

• すべてのサーバーが稼働していることを確認します：ps aux | grep python
• Claude Desktop の設定パスを確認します
• すべての API キーが有効で、十分な利用枠があることを確認します

結果に一貫性がない場合：

• 一部の API にはレート制限があるため、リクエストの間隔を空けてください
• 為替レートや航空券の価格は頻繁に変動します
• 天気予報は、7 日を超えると精度が低下します

予算の計算が正しくない場合：

• 常に finance サーバーから最新の為替レートを取得してください
• ホテルや航空券の価格には予約手数料と税金を含めてください
• 季節による価格の変動を考慮してください

パフォーマンスの最適化

• キャッシュ：ほとんどのサーバーは、API 呼び出しを減らすために結果をローカルにキャッシュします
• 並列処理：Claude は複数のサーバーに同時に問い合わせることができます
• スマートな絞り込み：まず広い条件で検索し、その後フィルターを使って絞り込んでください

🤝 貢献

このエコシステムは、コミュニティからの貢献によって発展します。

1. 新しいサーバーの種類：レストランの予約、レンタカー、旅行保険
2. フィルタリングの強化：より高度な希望条件のマッチング
3. 連携の改善：サーバー間のデータ共有とキャッシュ
4. モバイル対応：MCP のサポートをモバイル旅行アプリに拡張

📄 ライセンス

この旅行アシスタントのエコシステムは、MIT License のもとでオープンソースとして公開されています。個々のサーバーでは異なるライセンスが適用される場合があります。各サーバーのドキュメントを確認してください。

🆘 サポート

以下に関する問題については：

• 個々のサーバー：該当するサーバーの README とリポジトリを確認してください
• 連携の問題：メインの travel-assistant-mcp リポジトリで issue を作成してください
• Claude Desktop：Anthropic のサポートドキュメントをご覧ください
• API の問題：各 API プロバイダー（SerpAPI、天気サービスなど）にお問い合わせください

---

MCP の強みは、従来なら複数のアプリと手動での調整が必要だった、複雑で複数のステップからなるワークフローをオーケストレーションできることにあります。この旅行アシスタントのエコシステムにより、Claude は複数の分野やデータソースにまたがる高度なリクエストに対応できる、インテリジェントな旅行エージェントになります。