MCP Hello World

🚀 Google Maps MCP Server

This is an MCP Server for the Google Maps API, which provides various tools to interact with Google Maps services.

🚀 Quick Start

To start using this Google Maps MCP Server, you first need to set it up. The following sections will guide you through the setup and usage steps.

✨ Features

Tools

1. maps_geocode

   • Convert an address to coordinates.
   • Input: address (string)
   • Returns: location, formatted_address, place_id

2. maps_reverse_geocode

   • Convert coordinates to an address.
   • Inputs:
     • latitude (number)
     • longitude (number)
   • Returns: formatted_address, place_id, address_components

3. maps_search_places

   • Search for places using a text query.
   • Inputs:
     • query (string)
     • location (optional): { latitude: number, longitude: number }
     • radius (optional): number (meters, max 50000)
   • Returns: an array of places with names, addresses, locations

4. maps_place_details

   • Get detailed information about a place.
   • Input: place_id (string)
   • Returns: name, address, contact info, ratings, reviews, opening hours

5. maps_distance_matrix

   • Calculate distances and times between points.
   • Inputs:
     • origins (string[])
     • destinations (string[])
     • mode (optional): "driving" | "walking" | "bicycling" | "transit"
   • Returns: distances and durations matrix

6. maps_elevation

   • Get elevation data for locations.
   • Input: locations (array of {latitude, longitude})
   • Returns: elevation data for each point

7. maps_directions

   • Get directions between points.
   • Inputs:
     • origin (string)
     • destination (string)
     • mode (optional): "driving" | "walking" | "bicycling" | "transit"
   • Returns: route details with steps, distance, duration

📦 Installation

API Key

Get a Google Maps API key by following the instructions here.

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

Docker

{
  "mcpServers": {
    "google-maps": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GOOGLE_MAPS_API_KEY",
        "mcp/google-maps"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "google-maps": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-google-maps"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

🔧 Technical Details

Build

You can build the Docker image using the following command:

docker build -t mcp/google-maps -f src/google-maps/Dockerfile .

📄 License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.