Travel Planner MCP Server

🚀 Travel Planning MCP Server (@gongrzhe/server-travelplanner-mcp)

This is a Travel Planning Model Context Protocol (MCP) server implementation that interacts with Google Maps and travel planning services. This server enables Large Language Models (LLMs) to perform travel - related tasks, such as location search, place details lookup, and travel time calculation.

🚀 Quick Start

📦 Installation

Install via Smithery

Automatically install the travel planner for Claude Desktop through Smithery:

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

Manual Installation

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

# Use Google Maps API with environment variables
GOOGLE_MAPS_API_KEY=your_api_key npx @gongrzhe/server-travelplanner-mcp

Or install globally:

# Global installation
npm install -g @gongrzhe/server-travelplanner-mcp

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

✨ Features

Tools

• searchPlaces

  • Search for places using the Google Places API.
  • Input:
    • query (string): Query term for searching places.
    • location (optional): Latitude and longitude to bias the results.
    • radius (optional): Search radius (in meters).

• getPlaceDetails

  • Get detailed information about a specific place.
  • Input:
    • placeId (string): Google Place ID for retrieving detailed information.

• calculateRoute

  • Calculate the route between two locations.
  • Input:
    • origin (string): Starting location.
    • destination (string): Ending location.
    • mode (optional): Mode of travel (driving, walking, bicycling, transit).

• getTimeZone

  • Get time zone information for a location.
  • Input:
    • location: Latitude and longitude coordinates.
    • timestamp (optional): Timestamp for calculating the time zone.

📚 Documentation

Configuration

Use with Claude Desktop

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

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

Development

Source Code Build

• Clone the repository:

git clone https://github.com/yourusername/your-repository.git
cd your-repository

• Install dependencies:

npm install

• Run the server:

npm start

Environment Variables

# Example of necessary environment variables
GOOGLE_MAPS_API_KEY=your_api_key_here

📄 License

This project is licensed under the LICENSE agreement.