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 端点

• 地点搜索：按名称和类别查找地点
• 地点详情：获取地点的完整信息
• 地点照片：查看地点的照片
• 地点评论：阅读地点的评论
• 附近搜索：查找特定地点附近的位置

故障排除

• 如果出现 401 Unauthorized 错误，请检查 API 密钥是否正确，以及你的 IP 是否已在 TripAdvisor Developer Portal 中加入白名单
• 如果 Claude Desktop 集成出现问题，请检查配置设置，并确认 server.py 的路径正确
• 如果 Claude 无法完成任务，很可能是输入 token 过多。通常问题出在 get_location_details_tool。