Tripadvisor

🚀 Tripadvisor MCP Server

A Model Context Protocol (MCP) server for the Tripadvisor Content API. This server provides access to Tripadvisor's location data, reviews, and photos. Through the standardized MCP interface, it enables AI assistants to search for travel destinations and experiences.

✨ Features

• [x] Search for locations (hotels, restaurants, attractions) on Tripadvisor.
• [x] Get detailed information about a specific location.
• [x] View reviews and photos of a location.
• [x] Search for nearby places based on coordinates.
• [x] API Key authentication.
• [x] Support for Docker containerization.
• [x] Provide interactive tools for AI assistants.

The tool list is configurable, so you can choose which tools to expose to MCP clients.

🚀 Quick Start

💻 Usage Examples

Basic Usage

1. Obtain your Tripadvisor Content API key from the Tripadvisor Developer Platform.

2. Configure environment variables to set up the Tripadvisor Content API. You can do this through a .env file or system environment variables:

# Required: Tripadvisor Content API configuration
TRIPADVISOR_API_KEY=your_api_key_here

3. Add the server configuration to your client configuration file. For example, in Claude Desktop:

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

⚠️ Important Note

If you see Error: spawn uv ENOENT in Claude Desktop, you may need to specify the full path of uv or set the environment variable NO_UV=1 in the configuration.

📦 Docker Usage

This project provides Docker support for easy deployment and environment isolation.

Build the Docker Image

Use the following command to build the image:

docker build -t tripadvisor-mcp-server .

Run the Docker Container Directly

• Method 1: Direct Run

docker run --rm -it -p 3001:3000 --name tripadvisor-mcp tripadvisor-mcp-server

• Method 2: Use a Configuration File

If you have a configuration file named config.json, you can mount it into the container:

docker run --rm -it -p 3001:3000 --name tripadvisor-mcp -v $(pwd)/config.json:/app/config.json tripadvisor-mcp-server

Run with Docker Compose

Create a docker-compose.yml file with the following content:

version: '3'
services:
  tripadvisor-mcp:
    image: tripadvisor-mcp-server
    restart: always
    ports:
      - "3001:3000"
    environment:
      - TRIPADVISOR_API_KEY=your_api_key_here

Then run:

docker-compose up --build

Use the Containerized Server in Claude Desktop

Add the following content to your configuration file to use the Docker image in Claude Desktop:

{
  "mcpServers": {
    "tripadvisor": {
      "containerName": "tripadvisor-mcp",
      "image": "tripadvisor-mcp-server:latest"
    }
  }
}

🔧 Technical Details

Clone the Project

Use the following command to clone the project locally:

git clone https://github.com/your-username/tripadvisor-mcp.git
cd tripadvisor-mcp

Install Dependencies

Navigate to the root directory of the project and run the following command to install dependencies:

npm install

Project Structure

The following is the file directory structure of the project:

tripadvisor-mcp/
├── src/                 # Source code directory
│   ├── services/       # API service modules
│   └── config.js      # Configuration file
├── Dockerfile          # Docker image build file
├── package.json        # Project dependencies and script configuration
└── docker-compose.yml  # Docker Compose configuration file

Testing

Run the Test Suite

In the root directory of the project, run the following command to execute all tests:

npm test

View Test Results

You can view the detailed output of the tests in the console and check for any failure or error messages.

📚 Documentation

Tool List

📄 License

This project is licensed under the MIT License.