Travel Planner
Created 6 months ago
A Travel Planner Model Context Protocol (MCP) server implementation for interacting with Google Maps and travel planning services.
What is Travel Planner?
Travel planning and itinerary management server integrating with Google Maps API for location search, place details, and route calculations.
Documentation
Travel Planner MCP Server
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
npx @gongrzhe/server-travelplanner-mcp\n\n# With environment variable for Google Maps API
GOOGLE_MAPS_API_KEY=your_api_key npx @gongrzhe/server-travelplanner-mcp
Or install globally:
npm install -g @gongrzhe/server-travelplanner-mcp\n\n# 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
- getPlaceDetails - Get detailed information about a specific place
- calculateRoute - Calculate route between two locations
- getTimeZone - Get timezone information for a location
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
- Clone the repository
- Install dependencies:
npm install
- 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.
Server Config
{
"mcpServers": {
"travel-planner-server": {
"command": "npx",
"args": [
"travel-planner"
]
}
}
}