npm package: @mcpflow.io/mcp-travel-planner-mcp-server-gongrzheserver-travelplanner-mcp
Description: 旅行规划和行程管理微服务服务器
Author: Gongrzhe, Inc.
Latest version: 1.0.1

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

<!-- MCPFlow Packaged MCP -->
> 此包由 [MCPFlow](https://mcpflow.io) 打包并发布到npm仓库。

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

## 安装与使用

直接使用npx运行:

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

或者先安装后使用:

```bash
# 安装
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](https://github.com/GongRzhe/TRAVEL-PLANNER-MCP-Server)

## 原始README

# Travel Planner MCP Server (@gongrzhe/server-travelplanner-mcp)
[![smithery badge](https://smithery.ai/badge/@GongRzhe/TRAVEL-PLANNER-MCP-Server)](https://smithery.ai/server/@GongRzhe/TRAVEL-PLANNER-MCP-Server)

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.

<a href="https://glama.ai/mcp/servers/y3u6yjiiq1">
  <img width="380" height="200" src="https://glama.ai/mcp/servers/y3u6yjiiq1/badge" alt="Travel Planner Server MCP server" />
</a>

## Installation & Usage
### Installing via Smithery

To install Travel Planner for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@GongRzhe/TRAVEL-PLANNER-MCP-Server):

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

### Installing Manually
```bash
# 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:

```bash
# 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`:

```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:

```json
{
  "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:
   ```bash
   npm install
   ```
3. Build the project:
   ```bash
   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.