A powerful Model Context Protocol (MCP) server providing comprehensive Google Maps API integration with streamable HTTP transport support and LLM processing capabilities.
This project has received contributions from the community.
Special thanks to @junyinnnn for helping add support for streamablehttp
.
This MCP server has been tested and verified to work correctly with:
- Claude Desktop
- Dive Desktop
- MCP protocol implementations
All tools and features are confirmed functional through real-world testing.
-
Location Search
- Search for places near a specific location with customizable radius and filters
- Get detailed place information including ratings, opening hours, and contact details
-
Geocoding Services
- Convert addresses to coordinates (geocoding)
- Convert coordinates to addresses (reverse geocoding)
-
Distance & Directions
- Calculate distances and travel times between multiple origins and destinations
- Get detailed turn-by-turn directions between two points
- Support for different travel modes (driving, walking, bicycling, transit)
-
Elevation Data
- Retrieve elevation data for specific locations
- Streamable HTTP Transport: Latest MCP protocol with real-time streaming capabilities
- Session Management: Stateful sessions with UUID-based identification
- Multiple Connection Support: Handle multiple concurrent client connections
- Echo Service: Built-in testing tool for MCP server functionality
npm install -g @cablate/mcp-google-map
mcp-google-map --port 3000 --apikey "your_api_key_here"
# Using short options
mcp-google-map -p 3000 -k "your_api_key_here"
# Show help information
mcp-google-map --help
- Main MCP Endpoint:
http://localhost:3000/mcp
- Available Tools: 8 tools including Google Maps services and echo
Alternatively, create a .env
file in your working directory:
# Required
GOOGLE_MAPS_API_KEY=your_google_maps_api_key_here
# Optional
MCP_SERVER_PORT=3000
Note: Command line options take precedence over environment variables.
The server provides the following tools:
- search_nearby - Search for nearby places based on location, with optional filtering by keywords, distance, rating, and operating hours
- get_place_details - Get detailed information about a specific place including contact details, reviews, ratings, and operating hours
- maps_geocode - Convert addresses or place names to geographic coordinates (latitude and longitude)
- maps_reverse_geocode - Convert geographic coordinates to a human-readable address
- maps_distance_matrix - Calculate travel distances and durations between multiple origins and destinations
- maps_directions - Get detailed turn-by-turn navigation directions between two locations
- maps_elevation - Get elevation data (height above sea level) for specific geographic locations
# Clone the repository
git clone https://github.com/cablate/mcp-google-map.git
cd mcp-google-map
# Install dependencies
npm install
# Set up environment variables
cp .env.example .env
# Edit .env with your API key
# Build the project
npm run build
# Start the server
npm start
# Or run in development mode
npm run dev
src/
βββ cli.ts # Main CLI entry point
βββ config.ts # Server configuration
βββ index.ts # Package exports
βββ core/
β βββ BaseMcpServer.ts # Base MCP server with streamable HTTP
βββ tools/
βββ echo.ts # Echo service tool
βββ maps/ # Google Maps tools
βββ toolclass.ts # Google Maps API client
βββ searchPlaces.ts # Maps service layer
βββ searchNearby.ts # Search nearby places
βββ placeDetails.ts # Place details
βββ geocode.ts # Geocoding
βββ reverseGeocode.ts # Reverse geocoding
βββ distanceMatrix.ts # Distance matrix
βββ directions.ts # Directions
βββ elevation.ts # Elevation data
- TypeScript - Type-safe development
- Node.js - Runtime environment
- Google Maps Services JS - Google Maps API integration
- Model Context Protocol SDK - MCP protocol implementation
- Express.js - HTTP server framework
- Zod - Schema validation
- API keys are handled server-side for security
- DNS rebinding protection available for production
- Input validation using Zod schemas
- Error handling and logging
MIT
Community participation and contributions are welcome! Here's how you can contribute:
- βοΈ Star the project if you find it helpful
- π Submit Issues: Report bugs or provide suggestions
- π§ Create Pull Requests: Submit code improvements
- π Documentation: Help improve documentation
If you have any questions or suggestions, feel free to reach out:
- π§ Email: reahtuoo310109@gmail.com
- π» GitHub: CabLate
- π€ Collaboration: Welcome to discuss project cooperation
- π Technical Guidance: Sincere welcome for suggestions and guidance
- Added streamable HTTP transport support
- Improved CLI interface with emoji indicators
- Enhanced error handling and logging
- Added comprehensive tool descriptions for LLM integration
- Updated to latest MCP SDK version
- Initial release with basic Google Maps integration
- Support for location search, geocoding, and directions
- Compatible with MCP protocol