MCP Google Maps
# MCP Google Maps [](https://github.com/BACH-AI-Tools/MCP-Google-Maps.git)
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](https://github.com/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:
```bash
npm install -g @bachstudio/mcp-google-maps
```
You can test if the MCP server is working by running:
```bash
npx bachstudio-mcp-google-maps
```
## MCP Configuration
To use this with your MCP client, add the following to your MCP configuration:
```json
{
"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](https://github.com/ArtixZ/MCP-Google-Maps)
TDQS
Scored across 8 tools
Every tool has a clearly distinct purpose with no ambiguity. For example, get_directions is for routing, get_distance_matrix is for multi-point calculations, and get_geocode vs get_reverse_geocode handle opposite conversions. The descriptions reinforce these unique functions, making tool selection straightforward.
All tools follow a consistent verb_noun pattern with 'get_' or 'search_' prefixes, such as get_directions, get_geocode, and search_nearby. This uniformity enhances readability and predictability, allowing agents to easily understand the tool set's structure.
With 8 tools, the count is well-scoped for a Google Maps server, covering core functionalities like directions, geocoding, place search, and maps. Each tool earns its place by addressing a specific aspect of location-based services without redundancy or bloat.
The tool set provides complete coverage for the Google Maps domain, including routing (directions, distance matrix), geospatial conversions (geocode, reverse geocode), place information (details, nearby search), and visualization (map with directions). No obvious gaps exist, enabling agents to handle typical mapping workflows effectively.