MCP Google Map Server logo

MCP Google Map Server

by Cablate

The MCP Google Map Server provides comprehensive Google Maps API integration with LLM processing capabilities. It enables location search, geocoding, distance calculations, and more.

View on GitHub

Last updated: N/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

npm install -g @cablate/mcp-google-map

Usage

Command Line

mcp-google-map

Integration with Dive Desktop

  1. Click "+ Add MCP Server" in Dive Desktop
  2. Copy and paste the following configuration:
{
  "mcpServers": {
    "google-map": {
      "command": "npx",
      "args": ["-y", "@cablate/mcp-google-map"],
      "env": {
        "GOOGLE_MAPS_API_KEY": "your_api_key"
      },
      "enabled": true
    }
  }
}
  1. 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
  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]
  • 📧 GitHub: CabLate
  • 🤝 Collaboration: Welcome to discuss project cooperation
  • 📚 Technical Guidance: Sincere welcome for suggestions and guidance