Google Maps MCP Server

This project provides a Python-based Model Context Protocol (MCP) server that leverages the Google Maps and Places APIs to answer queries about local businesses and tourist attractions in India. It is designed to help users and developers easily retrieve information such as "What are the best cafes in Bangalore?" or "Top-rated tourist places near Hyderabad" using a simple MCP interface.

Features

Query Google Maps for places, restaurants, tourist attractions, and more
Easily configurable with your own Google Maps API key
Modular, maintainable, and testable codebase
Ready for extension and contribution

Getting Started

Prerequisites

Python 3.8+
A Google Maps API key (Get one here)

Run the MCP server

Install uvx using

curl -LsSf https://astral.sh/uv/install.sh | sh

Run the MCP server-

uvx google-mcp-server

Contributing

Fork this repository and create a feature branch.
Add or update tests for your changes.
Submit a pull request with a clear description of your changes.

Setup Steps

Clone the repository:

git clone <your-fork-url>
cd google_maps_mcp

Build: Go to the root of the project and run-
```
uv build
```
Set your Google Maps API key:
- You can set it in your environment or in the config (see below).
- Example (Linux/macOS):
```
export GOOGLE_MAPS_API_KEY=your_api_key_here
```
Install the local build as an executable: Ensure that your PATH env var contains the ~/.local/bin path.

If not, add this to the end of your ~/.bashrc file.
```
export PATH=$PATH:~/.local/bin
```
and then run-
```
source ~/.bashrc
```

Run the executable containing the MCP server:

uvx dist/google_maps_mcp-1.0.0-py3-none-any.whl

Visual Studio Code: MCP Server Configuration Example

"mcp": {
        "servers": {
            "google_maps_mcp_server":{
                "type": "stdio",
                "command": "uvx",
                "args": ["google-maps-mcp"],
                "env": {
                    "GOOGLE_MAPS_API_KEY": "<your google maps API key>"
                }
            }
        }
    }

Google Maps