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. 转到 设置 > MCP 服务器
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. 只需提示任何带有“旅行规划器”提示的内容
3. 按照交互式提示来规划你的完美假期！

使用的 API 端点

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

故障排除

• 如果看到 401 未授权错误，请检查你的 API 密钥是否正确，并且你的 IP 是否在 TripAdvisor 开发者门户中被白名单
• 对于与 Claude Desktop 的集成问题，请验证你的配置设置，并确保 server.py 的路径是正确的
• 如果 Claude 无法完成操作，则很可能是因为你使用的输入令牌过多。get_location_details_tool 通常是罪魁祸首。