mcp-google-map

mcp-google-map is a powerful Model Context Protocol (MCP) server that provides comprehensive integration with the Google Maps API. This tool offers various functionalities, including location search, geocoding, distance and directions calculation, and elevation data retrieval. With large language model (LLM) processing capabilities, developers can easily manipulate map-related data. Built with TypeScript, it operates in a Node.js environment.

GitHub Stars

45

User Rating

Not Rated

Forks

21

Issues

1

Views

0

Favorites

0

README

MseeP.ai Security Assessment Badge

Google Map Server MCP server
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: reahtuoo310109@gmail.com
  • 📧 GitHub: CabLate
  • 🤝 Collaboration: Welcome to discuss project cooperation
  • 📚 Technical Guidance: Sincere welcome for suggestions and guidance
Author Information

9

Followers

15

Repositories

0

Gists

10

Total Contributions

Top Contributors

Threads