Add Google Maps

src/google-maps/README.md

@@ -0,0 +1,65 @@
+# Google Maps MCP Server
+
+MCP Server for the Google Maps API.
+
+## Tools
+
+1. `geocode`
+   - Convert address to coordinates
+   - Input: `address` (string)
+   - Returns: location, formatted_address, place_id
+
+2. `reverse_geocode`
+   - Convert coordinates to address
+   - Inputs:
+     - `latitude` (number)
+     - `longitude` (number)
+   - Returns: formatted_address, place_id, address_components
+
+3. `search_places`
+   - Search for places using text query
+   - Inputs:
+     - `query` (string)
+     - `location` (optional): { latitude: number, longitude: number }
+     - `radius` (optional): number (meters, max 50000)
+   - Returns: array of places with names, addresses, locations
+
+4. `get_place_details`
+   - Get detailed information about a place
+   - Input: `place_id` (string)
+   - Returns: name, address, contact info, ratings, reviews, opening hours
+
+5. `get_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. `get_elevation`
+   - Get elevation data for locations
+   - Input: `locations` (array of {latitude, longitude})
+   - Returns: elevation data for each point
+
+7. `get_directions`
+   - Get directions between points
+   - Inputs:
+     - `origin` (string)
+     - `destination` (string)
+     - `mode` (optional): "driving" | "walking" | "bicycling" | "transit"
+   - Returns: route details with steps, distance, duration
+
+## Setup
+
+1. Get a Google Maps API key by following the instructions [here](https://developers.google.com/maps/documentation/javascript/get-api-key#create-api-keys).
+
+2. To use this with Claude Desktop, add the following to your `claude_desktop_config.json`:
+    ```json
+        "mcp-server-google-maps": {
+        "command": "mcp-server-google-maps",
+        "env": {
+            "GOOGLE_MAPS_API_KEY": "<YOUR_API_KEY>"
+        }
+    }
+    ```