TripAdvisor Vacation Planner MCP Server

TripAdvisor バケーションプランナー MCP サーバー

この MCP サーバーを使用すると、TripAdvisor のデータにアクセスして、旅行の計画、観光スポット・レストラン・ホテルの検索ができます。

機能

• 名前とカテゴリで場所を検索
• 特定の場所の詳細情報を取得
• 周辺の観光スポット、レストラン、ホテルを検索
• 写真とレビューを表示
• インタラクティブな旅行計画プロンプト

セットアップ手順

前提条件

• Python 3.10 以降
• uv - 高速な Python パッケージインストーラーおよびリゾルバー
• TripAdvisor API キー（TripAdvisor Developer Portal から取得してください）
• Claude Desktop
• Google Maps MCP Server (https://github.com/modelcontextprotocol/servers/tree/main/src/google-maps)

uv を使ったインストール

1. このリポジトリをクローンします
2. 仮想環境を作成して有効化します：

   uv venv
   # On Windows
   .venv\Scripts\activate
   # On macOS/Linux
   source .venv/bin/activate
   

3. 必要な依存関係をインストールします：

   uv add "mcp[cli]"
   

サーバーの実行

次のコマンドでサーバーを直接実行できます：

# Set your API key as an environment variable
export TRIPADVISOR_API_KEY=your_api_key_here  # Linux/macOS
set TRIPADVISOR_API_KEY=your_api_key_here     # Windows Command Prompt
$env:TRIPADVISOR_API_KEY="your_api_key_here"  # Windows PowerShell

# Run the server
mcp run server.py

Claude Desktop 用のセットアップ

次の手順で MCP サーバーをセットアップします：

mcp install server.py

Claude Desktop の設定

1. Claude Desktop を開きます
2. Settings > MCP Servers に移動します
3. 次の設定で新しいサーバーを追加します：

   {
     "tripadvisor": {
       "command": "uv",
       "args": [
         "run",
         "--with",
         "mcp[cli]",
         "mcp",
         "run",
         "PATH_TO_YOUR_PROJECT\\server.py"
       ],
       "env": {
         "TRIPADVISOR_API_KEY": "YOUR_API_KEY_HERE"
       }
     }
   }
   

4. PATH_TO_YOUR_PROJECT をプロジェクトディレクトリの絶対パスに置き換えます
5. YOUR_API_KEY_HERE を実際の TripAdvisor API キーに置き換えます

バケーションプランナーの使用

1. Claude で新しい会話を開始します
2. 「Vacation Planner」プロンプトを使って、自由にプロンプトを入力します
3. インタラクティブなプロンプトに従って、理想の旅行を計画します！

使用する API エンドポイント

• Location Search：名前とカテゴリで場所を検索
• Location Details：場所に関する包括的な情報を取得
• Location Photos：場所の写真を表示
• Location Reviews：場所のレビューを読む
• Nearby Search：指定した地点の周辺にある場所を検索

トラブルシューティング

• 401 Unauthorized エラーが表示される場合は、API キーが正しいこと、および TripAdvisor Developer Portal で IP アドレスが許可リストに登録されていることを確認してください
• Claude Desktop との連携に問題がある場合は、設定を確認し、server.py へのパスが正しいことを確認してください
• Claude が処理を完了できない場合は、入力トークンを使いすぎている可能性が高いです。通常、原因は get_location_details_tool です。