Tripadvisor Vacation Planner

🚀 携程旅行計画アシスタント MCP サーバー

この MCP サーバーは、携程のデータへのアクセス権を提供し、休暇計画の立案や観光名所、レストラン、ホテルの検索に利用できます。

✨ 主な機能

• 名前とカテゴリーで場所を検索する
• 特定の場所の詳細情報を取得する
• 近くの観光名所、レストラン、ホテルを探す
• 写真とレビューを見る
• インタラクティブな旅行計画のアドバイスを受ける

📦 インストール

前提条件

• Python 3.10 以上
• uv - 高速な Python パッケージインストーラーと解析器
• 携程 API キー（携程開発者ポータル から取得）
• Claude Desktop
• Google Maps MCP サーバー（GitHub を参照）

uv を使用したインストール

1. このリポジトリをクローンします。
2. 仮想環境を作成してアクティブ化します。

   uv venv
   # Windows の場合
   .venv\Scripts\activate
   # macOS/Linux の場合
   source .venv/bin/activate
   

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

   uv add "mcp[cli]"
   

サーバーの起動

サーバーを直接起動することができます。

# API キーを環境変数に設定する
export CTRIP_API_KEY=your_api_key_here  # Linux/macOS
set CTRIP_API_KEY=your_api_key_here     # Windows コマンドプロンプト
$env:CTRIP_API_KEY="your_api_key_here"  # Windows PowerShell

# サーバーを起動する
mcp run server.py

Claude Desktop での設定

以下のコマンドを使用して MCP サーバーをインストールします。

mcp install server.py

Claude Desktop の設定

1. Claude Desktop を開きます。
2. 「設定」>「MCP サーバー」に移動します。
3. 次のように新しいサーバー設定を追加します。

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

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

旅行計画アシスタントの使用

1. Claude で新しい会話を開始します。
2. 「旅行計画アシスタント」というプロンプトで任意の質問を始めます。
3. インタラクティブなアドバイスに従って、完璧な休暇を計画しましょう！

📚 ドキュメント

使用される API エンドポイント

• 地理位置検索：名前とカテゴリーで地理位置を検索する
• 地理位置詳細情報：地理位置の詳細情報を取得する
• 地理位置写真：地理位置の写真を表示する
• 地理位置レビュー：地理位置のレビューを読む
• 近くの検索：特定の地点の近くの地理位置を検索する

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

⚠️ 重要な注意事項

• 401 未承認エラーが表示された場合は、API キーが正しいことを確認し、携程開発者ポータルで IP アドレスをホワイトリストに登録してください。
• Claude Desktop の統合に問題がある場合は、設定を確認し、server.py のパスが正しいことを確認してください。
• Claude が完了できない場合は、入力トークンが多すぎる可能性があります。get_location_details_tool が原因であることが多いです。