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 密鑰是否正確，並確保在攜程開發人員門戶中 whitelist 您的 IP 地址。
• ⚠️ 對於 Claude Desktop 集成問題，驗證您的配置設置，並確保 server.py 的路徑是正確的。
• ⚠️ 如果 Claude 無法完成，則很有可能是輸入令牌過多。get_location_details_tool 通常是罪魁禍首。