📌Overview

Purpose: To provide a server implementation for the Travel Planner Model Context Protocol (MCP) that allows interaction with Google Maps and travel planning services through various travel-related tasks.

Overview: The Travel Planner MCP Server enables large language models (LLMs) to conduct functions like location searches, retrieving place details, and calculating travel times. It integrates seamlessly with Google Maps to enhance travel planning capabilities.

Key Features:

• searchPlaces: Utilizes the Google Places API to search for locations based on a user-defined query, with options for location bias and search radius.

• getPlaceDetails: Retrieves detailed information about a specific location using its Google Place ID, providing users insights into specific places they may be interested in.

• calculateRoute: Computes travel routes between two locations, supporting various travel modes such as driving, walking, and transit to cater to different user preferences.

• getTimeZone: Fetches timezone information for a specified location, which can include an optional timestamp for more precise data in travel planning scenarios.

---

Travel Planner MCP Server

A Travel Planner Model Context Protocol (MCP) server for interacting with Google Maps and travel planning services. This server enables LLMs to perform travel-related tasks such as location search, place details lookup, and travel time calculations.

Installation & Usage

Installing via Smithery

To install Travel Planner for Claude Desktop via Smithery:

npx -y @smithery/cli install @GongRzhe/TRAVEL-PLANNER-MCP-Server --client claude

Installing Manually

# Using npx (recommended)
npx @gongrzhe/server-travelplanner-mcp

# With Google Maps API key
GOOGLE_MAPS_API_KEY=your_api_key npx @gongrzhe/server-travelplanner-mcp

Or install globally:

# Install globally
npm install -g @gongrzhe/server-travelplanner-mcp

# Run after global installation
GOOGLE_MAPS_API_KEY=your_api_key @gongrzhe/server-travelplanner-mcp

Components

Tools

• searchPlaces: Search for places using Google Places API.
• getPlaceDetails: Get detailed information about a specific place.
• calculateRoute: Calculate route between two locations.
• getTimeZone: Get timezone information for a location.

Configuration

Usage with Claude Desktop

To use this server with Claude Desktop, add the following configuration to the "mcpServers" section of your claude_desktop_config.json:

{
  "mcpServers": {
    "travel-planner": {
      "command": "npx",
      "args": ["@gongrzhe/server-travelplanner-mcp"],
      "env": {
        "GOOGLE_MAPS_API_KEY": "your_google_maps_api_key"
      }
    }
  }
}

Alternatively, use the node command if the package is installed:

{
  "mcpServers": {
    "travel-planner": {
      "command": "node",
      "args": ["path/to/dist/index.js"],
      "env": {
        "GOOGLE_MAPS_API_KEY": "your_google_maps_api_key"
      }
    }
  }
}

Development

Building from Source

1. Clone the repository.
2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

Environment Variables

• GOOGLE_MAPS_API_KEY (required): Your Google Maps API key with the relevant APIs enabled.

License

This MCP server is licensed under the MIT License. For more details, see the LICENSE file in the project repository.