tripadvisor

This MCP server provides access to Tripadvisor content via standardized MCP interfaces, enabling AI assistants to search for locations (hotels, restaurants, attractions), retrieve detailed location data, and fetch reviews and photos. The server exposes tools such as search_locations, search_nearby_locations, get_location_details, get_location_reviews, and get_location_photos, which can be invoked through the MCP protocol by your client (for example Claude Desktop or any MCP-enabled client). To use it, obtain a Tripadvisor Content API key, configure it in the environment (TRIPADVISOR_API_KEY), and run the MCP server with uv pointing to the main application entry (src/tripadvisor_mcp/main.py). When connected, clients can perform queries like locating destinations, exploring nearby spots, and gathering media and reviews for richer responses.

Prerequisites:

• Python 3.8+ installed on your system
• uv (the MCP runtime) installed
• A Tripadvisor Content API key

Step-by-step:

1. Install uv and project dependencies: uv venv source .venv/bin/activate # Unix/macOS .venv\Scripts\activate # Windows uv pip install -e .

2. Obtain a Tripadvisor API key from the Tripadvisor Developer Portal and keep it handy.

3. Prepare environment variables:

   • Create a .env file or set environment variables in your environment: TRIPADVISOR_API_KEY=your_api_key_here

4. Run the MCP server using uv, pointing to the main application: uv --directory <full path to tripadvisor-mcp directory> run src/tripadvisor_mcp/main.py

5. (Optional) If integrating with Claude Desktop or another client, add the server configuration to your client config (see README for example).

Tips and notes:

• Ensure your TRIPADVISOR_API_KEY is valid and has the necessary permissions for the Content API.
• If you encounter Error: spawn uv ENOENT in Claude Desktop, provide the full path to the uv executable or set NO_UV=1 in the client config.
• Docker usage is supported as an alternative deployment path if you prefer containerization (see README for docker/run examples).
• The MCP server uses the uv tool to manage dependencies and run the Python application; ensure your environment can access the required Python packages.
• If you plan to run in CI or via Docker, consider mounting the directory containing src/tripadvisor_mcp and passing the API key securely via environment variables.