MCP Google Map

🚀 MCP Google Maps Server

A powerful Model Context Protocol (MCP) server fully integrated with the Google Maps API and equipped with LLM processing capabilities.

🚀 Quick Start

The MCP Google Maps Server is a robust tool that combines Google Maps API features with LLM processing. It offers a wide range of location - related services.

✨ Features

Google Maps Features

• Location Search

  • Search for places near a specific location, with support for custom radii and filters.
  • Obtain detailed location information, including ratings, business hours, and contact details.

• Geocoding Services

  • Convert addresses to coordinates (forward geocoding).
  • Convert coordinates to addresses (reverse geocoding).

• Distance and Routes

  • Calculate distances and travel times between multiple origins and destinations.
  • Get detailed routes between two points, including step - by - step instructions.
  • Support multiple travel modes (driving, walking, cycling, public transport).

• Elevation Data

  • Retrieve elevation information for a specific location.

📦 Installation

Via NPM

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

💻 Usage Examples

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
    }
  }
}

3. Click “Save” to complete the installation.

📚 Documentation

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 the route between two points.
7. maps_elevation - Get the elevation information for a specific location.

Google Maps API Setup

To use this service, you need to:

1. Create a project in the Google Cloud Console.
2. Enable the Google Maps API services.
3. Obtain an API key.
4. Set the GOOGLE_MAPS_API_KEY environment variable.

🔧 Technical Details

The server is built using the following technologies:

• TypeScript
• Node.js
• Google Maps Services JS
• Model Context Protocol SDK

📄 License

MIT

🤝 Contribution Guidelines

We welcome community participation and contributions! Here's how you can get involved:

• ⭐️ Star the project if you find it helpful.
• 🐛 Submit issues: Report bugs or provide suggestions.
• 🔧 Submit pull requests: Contribute code improvements.

📞 Contact

If you have any questions or suggestions, feel free to contact us:

• 📧 Email: reahtuoo310109@gmail.com
• 📧 GitHub: CabLate
• 🤝 Collaboration: We welcome discussions about project collaboration.
• 📚 Technical guidance: We sincerely welcome suggestions and guidance.