Tripadvisor MCP Server

Tripadvisor MCP Server

Standardized MCP access to Tripadvisor travel data for AI assistants

47
Stars
11
Forks
47
Watchers
3
Issues
Tripadvisor MCP Server provides Model Context Protocol (MCP) compliant access to Tripadvisor's Content API, enabling AI assistants to search, retrieve, and present travel-related information in a standardized way. It features endpoints for searching locations, accessing detailed information, reviews, and photos, as well as secure API key authentication. The project supports Docker containerization and interactive tools for customizable AI integration.

Key Features

Tripadvisor location (hotel, restaurant, attraction) search
Detailed retrieval of location information
Access to location reviews and photos
Nearby location search by coordinates
API key authentication support
Configurable set of interactive AI tools
Docker support for easy deployment
Integration with AI assistant clients (e.g., Claude Desktop)
Project organized for maintainability (src structure)
uv-based dependency management

Use Cases

Powering AI travel assistants with real, up-to-date Tripadvisor data
Enabling chatbots to suggest hotels, restaurants, and attractions
Giving AI the ability to fetch and summarize user reviews for locations
Providing destination research tools within AI-driven applications
Integrating travel recommendations into virtual agent platforms
Building location-based search and recommendation systems
Deploying standardized travel information APIs for custom workflows
Showcasing real-world travel experiences through AI interfaces
Allowing AI to perform proximity-based searches for travel planning
Rapidly spinning up isolated review/location search services via Docker

README

Tripadvisor MCP Server

A Model Context Protocol (MCP) server for Tripadvisor Content API.

This provides access to Tripadvisor location data, reviews, and photos through standardized MCP interfaces, allowing AI assistants to search for travel destinations and experiences.

Features

  • Search for locations (hotels, restaurants, attractions) on Tripadvisor

  • Get detailed information about specific locations

  • Retrieve reviews and photos for locations

  • Search for nearby locations based on coordinates

  • API Key authentication

  • Docker containerization support

  • Provide interactive tools for AI assistants

The list of tools is configurable, so you can choose which tools you want to make available to the MCP client.

Usage

  1. Get your Tripadvisor Content API key from the Tripadvisor Developer Portal.

  2. Configure the environment variables for your Tripadvisor Content API, either through a .env file or system environment variables:

env
# Required: Tripadvisor Content API configuration
TRIPADVISOR_API_KEY=your_api_key_here
  1. Add the server configuration to your client configuration file. For example, for Claude Desktop:
json
{
  "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"
      }
    }
  }
}

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

Docker Usage

This project includes Docker support for easy deployment and isolation.

Building the Docker Image

Build the Docker image using:

bash
docker build -t tripadvisor-mcp-server .

Running with Docker

You can run the server using Docker in several ways:

Using docker run directly:

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

Using docker-compose:

Create a .env file with your Tripadvisor API key and then run:

bash
docker-compose up

Running with Docker in Claude Desktop

To use the containerized server with Claude Desktop, update the configuration to use Docker with the environment variables:

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

This configuration passes the environment variables from Claude Desktop to the Docker container by using the -e flag with just the variable name, and providing the actual values in the env object.

Development

Contributions are welcome! Please open an issue or submit a pull request if you have any suggestions or improvements.

This project uses uv to manage dependencies. Install uv following the instructions for your platform:

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

You can then create a virtual environment and install the dependencies with:

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

Project Structure

The project has been organized with a src directory structure:

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

Testing

The project includes a test suite that ensures functionality and helps prevent regressions.

Run the tests with pytest:

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

# Run the tests
pytest

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

Tools

Tool Category Description
search_locations Search Search for locations by query text, category, and other filters
search_nearby_locations Search Find locations near specific coordinates
get_location_details Retrieval Get detailed information about a location
get_location_reviews Retrieval Retrieve reviews for a location
get_location_photos Retrieval Get photos for a location

License

MIT


Star History

Star History Chart

Repository Owner

pab1it0
pab1it0

User

Repository Details

Language Python
Default Branch main
Size 35 KB
Contributors 1
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

Python
84.01%
Dockerfile
15.99%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • mcp-kibela

    mcp-kibela

    MCP server for secure, AI-assisted access to Kibela notes.

    mcp-kibela is a Model Context Protocol (MCP) server implementation that enables AI assistants to search, retrieve, create, and update content from Kibela, a team knowledge-sharing platform. It provides standardized endpoints for note search, fetching individual or recent notes, and managing note content. Integrating with tools like Claude, Cursor, and VSCode, it allows seamless, secure access to organizational knowledge through MCP-enabled clients. Authentication via environment variables ensures secure connections to Kibela APIs.

    • 12
    • MCP
    • kj455/mcp-kibela
  • AllTrails MCP Server

    AllTrails MCP Server

    MCP server for seamless AllTrails data access and integration

    AllTrails MCP Server provides Model Context Protocol (MCP) compliant access to AllTrails hiking trail data, enabling AI tools to search for trails and retrieve detailed trail information. It supports searching by national park and fetching comprehensive details such as difficulty, length, elevation, ratings, and route types. The server communicates via standard input/output and is designed for easy integration with MCP-compatible clients like Claude Desktop. Installation is flexible, supporting both virtual environments and system Python setups.

    • 6
    • MCP
    • srinath1510/alltrails-mcp-server
  • Unichat MCP Server

    Unichat MCP Server

    Universal MCP server providing context-aware AI chat and code tools across major model vendors.

    Unichat MCP Server enables sending standardized requests to leading AI model vendors, including OpenAI, MistralAI, Anthropic, xAI, Google AI, DeepSeek, Alibaba, and Inception, utilizing the Model Context Protocol. It features unified endpoints for chat interactions and provides specialized tools for code review, documentation generation, code explanation, and programmatic code reworking. The server is designed for seamless integration with platforms like Claude Desktop and installation via Smithery. Vendor API keys are required for secure access to supported providers.

    • 37
    • MCP
    • amidabuddha/unichat-mcp-server
  • Make MCP Server (legacy)

    Make MCP Server (legacy)

    Enable AI assistants to utilize Make automation workflows as callable tools.

    Make MCP Server (legacy) provides a Model Context Protocol (MCP) server that connects AI assistants with Make scenarios configured for on-demand execution. It parses and exposes scenario parameters, allowing AI systems to invoke automation workflows and receive structured JSON outputs. The server supports secure integration through API keys and facilitates seamless communication between AI and Make's automation platform.

    • 142
    • MCP
    • integromat/make-mcp-server
  • Azure DevOps MCP Server

    Azure DevOps MCP Server

    Standardized AI access to Azure DevOps via Model Context Protocol.

    Implements the Model Context Protocol (MCP) to enable AI assistants to securely and efficiently interact with Azure DevOps resources. Provides a standardized bridge for managing projects, work items, repositories, pull requests, and pipelines through natural language interfaces. Supports modular authentication and a feature-based architecture for scalability and integration. Facilitates seamless integration with AI tools such as Claude Desktop and Cursor AI.

    • 306
    • MCP
    • Tiberriver256/mcp-server-azure-devops
  • MCP Server Giphy

    MCP Server Giphy

    MCP-compatible Giphy API server for AI models to search and retrieve GIFs.

    MCP Server Giphy provides an MCP-compliant server interface for accessing GIFs from the Giphy API, specifically tailored for seamless integration with AI models. It supports content filtering, multiple retrieval methods (search, trending, random), and optimized response formats with comprehensive metadata. The server enables AI applications to search, retrieve, and utilize GIF content efficiently, and is easily configurable with tools like Claude Desktop.

    • 22
    • MCP
    • magarcia/mcp-server-giphy
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results