TripAdvisor 假期规划器 MCP 服务器

此 MCP 服务器提供对 TripAdvisor 数据的访问，用于规划假期、查找景点、餐厅和酒店。

功能

• 按名称和类别搜索地点
• 获取有关特定地点的详细信息
• 查找附近的景点、餐厅和酒店
• 查看照片和评论
• 交互式假期规划提示

设置说明

前提条件

• Python 3.10 或更高版本
• uv - 快速 Python 包安装程序和解析器
• TripAdvisor API 密钥（从 TripAdvisor 开发者门户 获取）
• Claude Desktop
• Google Maps MCP 服务器 (https://github.com/modelcontextprotocol/servers/tree/main/src/google-maps)

使用 uv 安装

1. 克隆此存储库
2. 创建并激活虚拟环境：

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

3. 安装所需的依赖项：

   uv add "mcp[cli]"
   

运行服务器

您可以直接运行服务器：

# 将您的 API 密钥设置为环境变量
export TRIPADVISOR_API_KEY=your_api_key_here  # Linux/macOS
set TRIPADVISOR_API_KEY=your_api_key_here     # Windows 命令提示符
$env:TRIPADVISOR_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. 转到 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 开发者门户中列入白名单
• 对于 Claude Desktop 集成问题，请验证您的配置设置，并确保 server.py 的路径正确
• 如果 Claude 无法完成，则很可能您使用了过多的输入令牌。 get_location_details_tool 通常是罪魁祸首。