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. 创建并激活虚拟环境：
   bash
   uv venv

   在 Windows 上

   .venvScriptsactivate

   在 macOS/Linux 上

   source .venv/bin/activate

3. 安装所需的依赖项：
   bash
   uv add "mcp[cli]"

运行服务器

你可以直接运行服务器：

bash

将你的 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服务器：

bash
mcp install server.py

配置 Claude Desktop

1. 打开 Claude Desktop

2. 转到设置 > MCP 服务器

3. 添加一个新的服务器，并使用以下配置：
   json
   {
   "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 未授权错误，请检查你的 API 密钥是否正确，并且你的 IP 已在 TripAdvisor 开发者门户中列入白名单
• 对于 Claude Desktop 集成问题，请验证你的配置设置，并确保 server.py 的路径正确
• 如果 Claude 无法完成任务，则很有可能是因为你使用的输入令牌过多。通常 get_location_details_tool 是罪魁祸首。