https://github.com/GongRzhe/TRAVEL-PLANNER-MCP-Server
Travel planning and itinerary management microservice server
https://github.com/GongRzhe/TRAVEL-PLANNER-MCP-Server
Last synced: 22 days ago
JSON representation
Travel planning and itinerary management microservice server
- Host: GitHub
- URL: https://github.com/GongRzhe/TRAVEL-PLANNER-MCP-Server
- Owner: GongRzhe
- License: mit
- Created: 2024-12-24T14:44:04.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-03-11T07:07:42.000Z (about 1 month ago)
- Last Synced: 2025-03-11T08:20:41.954Z (about 1 month ago)
- Language: JavaScript
- Size: 6.59 MB
- Stars: 6
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - Travel Planner - Provides travel planning functionalities like location search, route calculation, and time zone retrieval via Google Maps APIs (Table of Contents / Travel and Transportation)
README
# Travel Planner MCP Server (@gongrzhe/server-travelplanner-mcp)
[](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.
## 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.