Tripadvisor MCP Server

基本能力

产品定位

Tripadvisor MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，用于访问 Tripadvisor 的内容 API。它提供了标准化的 MCP 接口，允许 AI 助手搜索旅游目的地和体验。

核心功能

• 搜索 Tripadvisor 上的位置（酒店、餐厅、景点）
• 获取特定位置的详细信息
• 检索位置的评论和照片
• 基于坐标搜索附近位置
• API 密钥认证
• Docker 容器化支持
• 为 AI 助手提供交互式工具

适用场景

• AI 助手需要访问 Tripadvisor 数据以提供旅游建议
• 开发者需要集成 Tripadvisor 内容 API 到他们的应用中
• 需要快速部署和隔离的服务环境

工具列表

常见问题解答

• 如果在 Claude Desktop 中看到 Error: spawn uv ENOENT，可能需要指定 uv 的完整路径或在配置中设置环境变量 NO_UV=1。

使用教程

使用依赖

安装 uv 以管理依赖：

curl -LsSf https://astral.sh/uv/install.sh | sh

安装教程

1. 从 Tripadvisor Developer Portal 获取 Tripadvisor Content API 密钥。
2. 通过 .env 文件或系统环境变量配置 API 密钥：

TRIPADVISOR_API_KEY=your_api_key_here

1. 将服务器配置添加到客户端配置文件中。例如，对于 Claude Desktop：

{
  "mcpServers": {
    "tripadvisor": {
      "command": "uv",
      "args": [
        "--directory",
        "<full path to tripadvisor-mcp directory>",
        "run",
        "src/tripadvisor_mcp/main.py"
      ],
      "env": {
        "TRIPADVISOR_API_KEY": "your_api_key_here"
      }
    }
  }
}

Docker 使用

构建 Docker 镜像

docker build -t tripadvisor-mcp-server .

直接运行 Docker

docker run -it --rm \
  -e TRIPADVISOR_API_KEY=your_api_key_here \
  tripadvisor-mcp-server

使用 docker-compose

创建 .env 文件并运行：

docker-compose up

在 Claude Desktop 中使用 Docker

更新配置以使用 Docker：

{
  "mcpServers": {
    "tripadvisor": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "TRIPADVISOR_API_KEY",
        "tripadvisor-mcp-server"
      ],
      "env": {
        "TRIPADVISOR_API_KEY": "your_api_key_here"
      }
    }
  }
}

调试方式

运行测试以确保功能正常：

# 安装开发依赖
uv pip install -e ".[dev]"

# 运行测试
pytest

# 运行覆盖率报告
pytest --cov=src --cov-report=term-missing

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。