TripAdvisor Vacation Planner MCP Server

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.