Integrations

Supports containerized deployment with Docker for isolation and easy setup, including configuration options for running the MCP server within Docker containers.
Provides access to Tripadvisor's Content API, enabling search for travel destinations, hotels, restaurants, and attractions, as well as retrieving detailed location information, reviews, photos, and nearby points of interest.

Tripadvisor MCP 服务器

Tripadvisor 内容 API 的模型上下文协议(MCP) 服务器。

这可以通过标准化的 MCP 界面访问 Tripadvisor 位置数据、评论和照片，从而让 AI 助手搜索旅行目的地和体验。

特征

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

工具列表是可配置的，因此您可以选择要向 MCP 客户端提供的工具。

用法

从Tripadvisor 开发者门户获取您的 Tripadvisor 内容 API 密钥。
通过.env文件或系统环境变量配置您的 Tripadvisor Content API 的环境变量：

# Required: Tripadvisor Content API configuration
TRIPADVISOR_API_KEY=your_api_key_here

将服务器配置添加到客户端配置文件中。例如，对于 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"
      }
    }
  }
}

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

Docker 使用

该项目包括 Docker 支持，以便于部署和隔离。

构建 Docker 镜像

使用以下方式构建 Docker 镜像：

docker build -t tripadvisor-mcp-server .

使用 Docker 运行

您可以通过多种方式使用 Docker 运行服务器：

直接使用 docker run：

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

使用docker-compose：

使用您的 Tripadvisor API 密钥创建一个.env文件，然后运行：

docker-compose up

在 Claude Desktop 中使用 Docker 运行

要将容器化服务器与 Claude Desktop 一起使用，请更新配置以使用带有环境变量的 Docker：

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

此配置使用仅带有变量名的-e标志将环境变量从 Claude Desktop 传递到 Docker 容器，并在env对象中提供实际值。

发展

欢迎贡献代码！如果您有任何建议或改进，请提交 issue 或 pull request。

本项目使用uv来管理依赖项。请按照您平台的说明安装uv ：

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

然后，您可以创建一个虚拟环境并使用以下命令安装依赖项：

uv venv
source .venv/bin/activate  # On Unix/macOS
.venv\Scripts\activate     # On Windows
uv pip install -e .

项目结构

该项目已采用src目录结构进行组织：

tripadvisor-mcp/
├── src/
│   └── tripadvisor_mcp/
│       ├── __init__.py      # Package initialization
│       ├── server.py        # MCP server implementation
│       ├── main.py          # Main application logic
├── Dockerfile               # Docker configuration
├── docker-compose.yml       # Docker Compose configuration
├── .dockerignore            # Docker ignore file
├── pyproject.toml           # Project configuration
└── README.md                # This file

测试

该项目包括一个测试套件，可确保功能并有助于防止回归。

使用 pytest 运行测试：

# Install development dependencies
uv pip install -e ".[dev]"

# Run the tests
pytest

# Run with coverage report
pytest --cov=src --cov-report=term-missing

工具

工具	类别	描述
`search_locations`	搜索	通过查询文本、类别和其他过滤器搜索位置
`search_nearby_locations`	搜索	查找特定坐标附近的位置
`get_location_details`	检索	获取有关位置的详细信息
`get_location_reviews`	检索	检索某个地点的评论
`get_location_photos`	检索	获取某个位置的照片

执照

麻省理工学院

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

MCP 服务器使 LLM 能够与 Tripadvisor API 交互，通过标准化 MCP 接口支持位置数据、评论和照片

Appeared in Searches

A server for finding vacation rentals, hotels, and booking options