Travel Planner

Provides travel planning actions via MCP using Google Maps APIs to search places, fetch details, calculate routes, and determine time zones.

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

This Travel Planner MCP Server lets you perform travel-related tasks through a model context protocol interface. You can search for places, fetch place details, calculate routes, and retrieve timezone information using Google Maps APIs, enabling seamless travel planning within your MCP-enabled workflow.

How to use

You use this server by running it in an MCP-enabled client environment and invoking its available tools. The four core tools are searchPlaces, getPlaceDetails, calculateRoute, and getTimeZone. Provide the required inputs for each tool, and the server will return structured results you can incorporate into your planning conversations.

How to install

Prerequisites: you should have Node.js installed on your system (version 14 or newer is recommended). You will also need a Google Maps API key with access to Places, Directions, Geocoding, and Time Zone APIs.

Option 1: Run with npx (recommended) and provide your API key as an environment variable when starting.

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

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

Option 2: Install globally and run after installation, providing your API key.

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

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

Configuration and usage notes

Two explicit runtime configurations are shown for running this MCP server. The first uses npx, which runs the package directly and accepts an environment variable for the API key. The second demonstrates running via a Node.js path to a built bundle. Include the API key in both cases.

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

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

Available tools

searchPlaces

Search for places using the Google Places API. Inputs: query (string), location (optional, lat/long), radius (optional, meters).

getPlaceDetails

Retrieve detailed information for a specific place by its Google Place ID. Input: placeId (string).

calculateRoute

Compute a route between two locations. Inputs: origin (string), destination (string), mode (optional: driving, walking, bicycling, transit).

getTimeZone

Get timezone information for a location. Inputs: location (lat/long), timestamp (optional).