MCP Google Maps

A Model Context Protocol (MCP) server for Google Maps functionality, providing access to places search, geocoding, directions, and more through the MCP interface.

基于原项目: 此项目基于 ArtixZ/MCP-Google-Maps 修改而来

Features

Places Search
Place Details
Geocoding and Reverse Geocoding
Distance Matrix
Directions
Elevation Data
Static Maps Generation

Installation & Testing

First, install the package globally:

npm install -g @bachstudio/mcp-google-maps

You can test if the MCP server is working by running:

npx bachstudio-mcp-google-maps

MCP Configuration

To use this with your MCP client, add the following to your MCP configuration:

{
    "mcpServers": {
        "google-maps": {
            "command": "npx",
            "args": ["-y", "@bachstudio/mcp-google-maps"],
            "env": {
                "GOOGLE_MAPS_API_KEY": "your_api_key_here",
                "DEFAULT_LANGUAGE": "en",
                "DEFAULT_REGION": "US",
                "MAX_REQUESTS_PER_SECOND": "50",
                "MAX_REQUESTS_PER_DAY": "100000",
                "ENABLE_CACHING": "true",
                "CACHE_TTL": "3600"
            },
            "enabled": true
        }
    }
}

Available MCP Commands

The following commands are available through the MCP interface:

search_nearby: Search for places near a location
get_place_details: Get detailed information about a specific place
get_geocode: Convert address to coordinates
get_reverse_geocode: Convert coordinates to address
get_distance_matrix: Calculate distances between multiple origins and destinations
get_directions: Get directions between two points
get_elevation: Get elevation data for locations
get_map_with_directions: Generate map visualizations with directions, waypoints, and static map images

License

MIT

Author

bachstudio

Credits

Based on the original project by artixz