旅行规划服务

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

  • by hhw67865
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 hhw67865/tripadvisor-mcp-server

使用说明

TripAdvisor度假计划MCP服务器

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

特性

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

安装说明

先决条件

  • Python 3.10或更高版本
  • 紫外线 -快速Python包安装程序和解析器
  • TripAdvisor API密钥(从 TripAdvisor开发者门户)
  • 克劳德桌面
  • 谷歌地图MCP服务器(https://github.com/modelcontextprotocol/servers/tree/main/src/google-maps)

紫外线安装

  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桌面

  1. 打开克劳德桌面
  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通常是罪魁祸首。