TripAdvisor Vacation Planner MCP Server

This MCP server provides access to TripAdvisor data for planning vacations, finding attractions, restaurants, and hotels.

Features

• Search for locations by name and category

• Get detailed information about specific locations

• Find nearby attractions, restaurants, and hotels

• View photos and reviews

• Interactive vacation planning prompt

Setup Instructions

Prerequisites

• Python 3.10 or higher

• uv - Fast Python package installer and resolver

• TripAdvisor API key (get one from TripAdvisor Developer Portal)

• Claude Desktop

• Google Maps MCP Server (https://github.com/modelcontextprotocol/servers/tree/main/src/google-maps)

Installation with uv

1. Clone this repository

2. Create and activate a virtual environment:

   uv venv # On Windows .venv\Scripts\activate # On macOS/Linux source .venv/bin/activate

3. Install the required dependencies:

   uv add "mcp[cli]"

Running the Server

You can run the server directly with:

Setting up for Claude Desktop

Set up the MCP Server with:

Configuring Claude Desktop

1. Open Claude Desktop

2. Go to Settings > MCP Servers

3. Add a new server with the following configuration:

   { "tripadvisor": { "command": "uv", "args": [ "run", "--with", "mcp[cli]", "mcp", "run", "PATH_TO_YOUR_PROJECT\\server.py" ], "env": { "TRIPADVISOR_API_KEY": "YOUR_API_KEY_HERE" } } }

4. Replace PATH_TO_YOUR_PROJECT with the absolute path to your project directory

5. Replace YOUR_API_KEY_HERE with your actual TripAdvisor API key

Using the Vacation Planner

1. Start a new conversation in Claude

2. Just prompt anything with "Vacation Planner" prompt

3. Follow the interactive prompts to plan your perfect vacation!

API Endpoints Used

• Location Search: Find locations by name and category

• Location Details: Get comprehensive information about a location

• Location Photos: View photos of a location

• Location Reviews: Read reviews of a location

• Nearby Search: Find locations near a specific point

Troubleshooting

• If you see 401 Unauthorized errors, check that your API key is correct and that your IP is whitelisted in the TripAdvisor Developer Portal

• For issues with Claude Desktop integration, verify your configuration settings and ensure the path to server.py is correct

• If Claude is failing to complete, then there is a high chance that you are using too many input tokens. get_location_details_tool is usually the culprit.