MCP Travel Assistant

🚀 🌟 MCP Travel Concierge Server

究極のAI旅行計画アシスタント - Google Travel ServicesとAmadeus Professional Systemsの両者の長所を兼ね備えた包括的なMCP（Model Context Protocol）サーバーです。

🚀 クイックスタート

このTravel Concierge Serverは、2つの強力な旅行プラットフォームを統合した包括的なソリューションです。

• 🌐 Google Travel Services (SerpAPI経由) - 消費者向けのフライト、ホテル、イベントの検索が可能です。
• 🏢 Amadeus Global Distribution System - 専門的な旅行業界の在庫と価格情報を提供します。

</a>

# リポジトリをクローンする
git clone https://github.com/your-username/mcp_travelassistant.git
cd mcp_travelassistant

# 依存関係をインストールする
pip install -r requirements.txt

# 環境変数のサンプルファイルをコピーする
cp env.example .env

# 必要なAPIキー
SERPAPI_KEY=your_serpapi_key_here
AMADEUS_API_KEY=your_amadeus_api_key_here
AMADEUS_API_SECRET=your_amadeus_api_secret_here
EXCHANGE_RATE_API_KEY=your_exchange_rate_api_key_here

• SERPAPI_KEY：SerpAPIから取得
• AMADEUS_API_KEY と AMADEUS_API_SECRET：Amadeus for Developersから取得
• EXCHANGE_RATE_API_KEY：ExchangeRate-APIから取得

3. サーバーを起動する

python travel_server.py

🔧 技術詳細

Claude Desktop用の設定

Claude Desktopの設定ファイル（通常は~/.cursor/mcp.jsonまたは~/Library/Application Support/Claude/claude_desktop_config.json）に以下の設定を追加します。

{
  "mcpServers": {
    "travel-concierge": {
      "command": "python",
      "args": ["combined_travel_server.py"],
      "cwd": "/path/to/your/mcp_travelassistant",
      "env": {
        "SERPAPI_KEY": "your_serpapi_key_here",
        "AMADEUS_API_KEY": "your_amadeus_api_key_here", 
        "AMADEUS_API_SECRET": "your_amadeus_api_secret_here",
        "EXCHANGE_RATE_API_KEY": "your_exchange_rate_api_key_here"
      }
    }
  }
}

UVパッケージマネージャー用の設定

UVを使用している場合は、以下の設定を使用できます。

{
  "mcpServers": {
    "travel-concierge": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/your/mcp_travelassistant/",
        "run", "python", "combined_travel_server.py"
      ],
      "env": {
        "SERPAPI_KEY": "your_serpapi_key_here",
        "AMADEUS_API_KEY": "your_amadeus_api_key_here",
        "AMADEUS_API_SECRET": "your_amadeus_api_secret_here", 
        "EXCHANGE_RATE_API_KEY": "your_exchange_rate_api_key_here"
      }
    }
  }
}

HTTPモード用の設定

サーバーをHTTPモードで実行する場合は、以下の設定を使用します。

{
  "mcpServers": {
    "travel-concierge": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/client-http",
        "http://localhost:8000/"
      ]
    }
  }
}

その後、以下のコマンドでサーバーを起動します。python travel_server.py --transport http --port 8000

🎯 利用可能なツール

✈️ フライト検索ツール

🏨 ホテル検索ツール

🎭 イベント＆アクティビティツール

🌍 ユーティリティツール

💻 使用例

包括的な旅行計画

# 複数のプロバイダーからフライトを検索する
google_flights = search_flights_serpapi(
    departure_id="JFK",
    arrival_id="CDG", 
    outbound_date="2025-06-15",
    return_date="2025-06-22",
    adults=2
)

amadeus_flights = search_flights_amadeus(
    originLocationCode="JFK",
    destinationLocationCode="CDG",
    departureDate="2025-06-15",
    returnDate="2025-06-22",
    adults=2
)

ホテル検索戦略

# まず座標を取得する
location = geocode_location("Paris city center")

# Google Hotelsを通じた消費者向け検索
google_hotels = search_hotels_serpapi(
    location="Paris city center",
    check_in_date="2025-06-15", 
    check_out_date="2025-06-22"
)

# Amadeusを通じた専門的な検索
amadeus_hotels = search_hotel_offers_amadeus(
    cityCode="PAR",
    checkInDate="2025-06-15",
    checkOutDate="2025-06-22"
)

完全な旅行計画

# 1. 目的地の座標を取得する
coords = geocode_location("Paris, France")

# 2. 天気を確認する
weather = get_weather_forecast(
    latitude=coords['latitude'],
    longitude=coords['longitude']
)

# 3. イベントを検索する
events = search_events_serpapi(
    query="concerts museums",
    location="Paris",
    date_filter="week"
)

# 4. 予算計画のために通貨を変換する
budget_eur = convert_currency(
    from_currency="USD",
    to_currency="EUR", 
    amount=2000
)

🌟 ベストプラクティス

1. デュアル検索戦略

フライトとホテルの検索では、両方のプラットフォームを常に検索して、最良の取引と包括的なオプションを確保しましょう。

2. 位置情報を最初に取得する

geocode_location()を使用して正確な座標を取得し、それを位置ベースの検索に使用しましょう。

3. 天気情報を統合する

get_weather_forecast()を使用してアクティビティ計画を決定する前に天気予報を確認しましょう。

4. 通貨計画を立てる

convert_currency()を使用して正確な国際旅行の予算を計画しましょう。

🔄 Dockerサポート

ビルドと実行

# Dockerイメージをビルドする
docker build -t travel-concierge .

# 環境変数を指定して実行する
docker run -p 8000:8000 \
  -e SERPAPI_KEY=your_key \
  -e AMADEUS_API_KEY=your_key \
  -e AMADEUS_API_SECRET=your_secret \
  -e EXCHANGE_RATE_API_KEY=your_key \
  travel-concierge

Docker Compose

# 環境変数ファイルをコピーする
cp env.example .env

# .envファイルを編集してAPIキーを設定する
# その後、以下のコマンドを実行する
docker-compose up

🐛 トラブルシューティング

一般的な問題

1. APIキーが不足している

   Error: SERPAPI_KEY environment variable is required
   

   解決策：.envファイルまたは環境変数にAPIキーを設定します。

2. ポートが既に使用中

   Error: Port 8000 is already in use
   

   解決策：--port 8001を使用して別のポートを指定します。

3. Amadeus認証エラー

   Error: Invalid API credentials
   

   解決策：AmadeusのAPIキーとシークレットが正しいことを確認します。

ヘルスチェック

HTTPモードで実行している場合は、http://localhost:8000/healthにアクセスしてサーバーが正常に動作していることを確認します。

📈 パフォーマンス

• 統一アーキテクチャ：単一のサーバーでオーバーヘッドと複雑さを削減します。
• 同時リクエスト：複数の同時リクエストを効率的に処理します。
• レート制限：外部API呼び出しに組み込みのレート制限があります。
• エラーハンドリング：包括的なエラーハンドリングと回復機能があります。

🤝 コントリビューション

1. リポジトリをフォークする
2. 機能ブランチを作成する (git checkout -b feature/amazing-feature)
3. 変更を加える
4. 必要に応じてテストを追加する
5. 変更をコミットする (git commit -m 'Add some amazing feature')
6. ブランチにプッシュする (git push origin feature/amazing-feature)
7. プルリクエストを作成する

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEファイルを参照してください。

🙏 謝辞

• Amadeus for Developers - 専門的な旅行業界のデータ
• SerpAPI - Google Servicesの統合
• Open-Meteo - 天気データサービス
• ExchangeRate-API - 通貨変換サービス
• Nominatim/OpenStreetMap - 地理コーディングサービス

🆘 サポート

サポートが必要な場合は、以下の手順を行ってください。

1. 上記のドキュメントを確認する
2. サンプル環境ファイルを確認する
3. 問題の詳細情報を含めてイシューを作成する

良い旅を！ ✈️🏨🎭🌍