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

此包由 MCPFlow 打包并发布到npm仓库。

旅行规划和行程管理微服务服务器

安装与使用

直接使用npx运行:

npx @mcpflow.io/mcp-travel-planner-mcp-server-gongrzheserver-travelplanner-mcp

或者先安装后使用:

# 安装
npm install @mcpflow.io/mcp-travel-planner-mcp-server-gongrzheserver-travelplanner-mcp

# 使用
npx @mcpflow.io/mcp-travel-planner-mcp-server-gongrzheserver-travelplanner-mcp

使用方法

Installation & Usage

工具函数

create_itinerary

Creates a personalized travel itinerary based on user preferences

参数:

• budget: Budget in USD
• origin: Starting location
• endDate: End date (YYYY-MM-DD)
• startDate: Start date (YYYY-MM-DD)
• destination: Destination location
• preferences: Travel preferences

optimize_itinerary

Optimizes an existing itinerary based on specified criteria

参数:

• itineraryId: ID of the itinerary to optimize
• optimizationCriteria: Criteria for optimization (time, cost, etc.)

search_attractions

Searches for attractions and points of interest in a specified location

参数:

• radius: Search radius in meters
• location: Location to search attractions
• categories: Categories of attractions

get_transport_options

Retrieves available transportation options between two points

参数:

• date: Travel date (YYYY-MM-DD)
• origin: Starting point
• destination: Destination point

get_accommodations

Searches for accommodation options in a specified location

参数:

• budget: Maximum price per night
• checkIn: Check-in date (YYYY-MM-DD)
• checkOut: Check-out date (YYYY-MM-DD)
• location: Location to search

原始信息

• 开发者: GongRzhe
• 版本: 1.0.0
• 许可证: MIT License
• 原始仓库: GongRzhe/TRAVEL-PLANNER-MCP-Server

原始README

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

A Travel Planner Model Context Protocol (MCP) server implementation 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 automatically 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 environment variable for Google Maps API
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
  • Input:
    • query (string): Search query for places
    • location (optional): Latitude and longitude to bias results
    • radius (optional): Search radius in meters

• getPlaceDetails

  • Get detailed information about a specific place
  • Input:
    • placeId (string): Google Place ID to retrieve details for

• calculateRoute

  • Calculate route between two locations
  • Input:
    • origin (string): Starting location
    • destination (string): Ending location
    • mode (optional): Travel mode (driving, walking, bicycling, transit)

• getTimeZone

  • Get timezone information for a location
  • Input:
    • location: Latitude and longitude coordinates
    • timestamp (optional): Timestamp for time zone calculation

Configuration

Usage with Claude Desktop

To use this server with the Claude Desktop app, 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, you can use the node command directly if you have the package 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 following APIs enabled:
  • Places API
  • Directions API
  • Geocoding API
  • Time Zone API

License

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