MCPt2 / README.md
Frank Fiegel
add MCP server badge
2568975
[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/cablate-mcp-google-map-badge.png)](https://mseep.ai/app/cablate-mcp-google-map)
<a href="https://glama.ai/mcp/servers/@cablate/mcp-google-map">
<img width="380" height="200" src="https://glama.ai/mcp/servers/@cablate/mcp-google-map/badge" alt="Google Map Server MCP server" />
</a>
# MCP Google Map Server
A powerful Model Context Protocol (MCP) server providing comprehensive Google Maps API integration with LLM processing capabilities.
## Features
### Google Maps Features
- **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 directions between two points with step-by-step instructions
- Support for different travel modes (driving, walking, bicycling, transit)
- **Elevation Data**
- Retrieve elevation data for specific locations
## Installation
### Via NPM
```bash
npm install -g @cablate/mcp-google-map
```
## Usage
### Command Line
```bash
mcp-google-map
```
### Integration with [Dive Desktop](https://github.com/OpenAgentPlatform/Dive)
1. Click "+ Add MCP Server" in Dive Desktop
2. Copy and paste the following configuration:
```json
{
"mcpServers": {
"google-map": {
"command": "npx",
"args": ["-y", "@cablate/mcp-google-map"],
"env": {
"GOOGLE_MAPS_API_KEY": "your_api_key"
},
"enabled": true
}
}
}
```
3. Click "Save" to complete the installation
## Available Tools
The server provides the following tools:
1. **search_nearby** - Search for places near a specific location
2. **get_place_details** - Get detailed information about a specific place
3. **maps_geocode** - Convert an address to coordinates
4. **maps_reverse_geocode** - Convert coordinates to an address
5. **maps_distance_matrix** - Calculate distances and times between multiple origins and destinations
6. **maps_directions** - Get directions between two points
7. **maps_elevation** - Get elevation data for specific locations
## Google Maps API Setup
To use this service, you need to:
1. Create a project in [Google Cloud Console](https://console.cloud.google.com/)
2. Enable Google Maps API services
3. Obtain an API key
4. Set the `GOOGLE_MAPS_API_KEY` environment variable
## Tech Stack
- TypeScript
- Node.js
- Google Maps Services JS
- Model Context Protocol SDK
## License
MIT
## Contributing
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
## Contact
If you have any questions or suggestions, feel free to reach out:
- πŸ“§ Email: [[email protected]](mailto:[email protected])
- πŸ“§ GitHub: [CabLate](https://github.com/cablate/)
- 🀝 Collaboration: Welcome to discuss project cooperation
- πŸ“š Technical Guidance: Sincere welcome for suggestions and guidance