Skip to main content
Glama
deenesjakoruzh
devsanthoshmk

Google Maps MCP Server

by devsanthoshmk
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

🗺️ Google Maps MCP Server (gmaps-mcp)

MCP Version Python License: MIT

Un servidor Google Maps Model Context Protocol (MCP) autocontenido y ligero, construido con el SDK oficial de MCP para Python. Proporciona a los agentes de IA (como Claude Desktop, Cursor, Cline y Antigravity) resultados de búsqueda estructurados, detalles de lugares, valoraciones, información de contacto, coordenadas y URL de Google Maps.

⚡ Características principales

  • Instalación con un solo comando: Se ejecuta al instante en cualquier lugar mediante uvx sin configuración manual del entorno.

  • 100% Autocontenido: El motor de extracción está integrado de forma nativa en el proceso mediante asyncio y aiohttp; no se requieren subprocesos externos, navegadores headless ni claves de API.

  • Datos estructurados de lugares enriquecidos: Devuelve IDs de lugar, nombres de negocios, categorías, direcciones, números de teléfono locales e internacionales, URLs de sitios web, coordenadas (lat/long), valoraciones con estrellas, recuentos de reseñas y enlaces directos a Google Maps.

  • Stdio y HTTP Streamable: Soporte nativo de stdio para clientes de IA de escritorio y streamable-http para despliegues remotos o en contenedores.

  • JSON-RPC limpio: Todo el registro interno se canaliza estrictamente a stderr, manteniendo el flujo del protocolo stdio 100% conforme.

Related MCP server: Google Maps MCP Server

🚀 Inicio rápido

Ejecuta directamente usando uvx:

# Run directly from GitHub repository
uvx --from git+https://github.com/<your-username>/gmaps-mcp.git gmaps-mcp

O desde un clon local:

uv run gmaps-mcp

🛠️ Configuración del cliente MCP

1. Claude Desktop

Añade esto a tu claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json en macOS, o %APPDATA%\Claude\claude_desktop_config.json en Windows):

{
  "mcpServers": {
    "google-maps": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/<your-username>/gmaps-mcp.git",
        "gmaps-mcp"
      ]
    }
  }
}

Si se ejecuta desde una carpeta local:

{
  "mcpServers": {
    "google-maps": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/gmap-mcp",
        "gmaps-mcp"
      ]
    }
  }
}

2. Cursor IDE

En Cursor, abre Settings → Features → MCP (o edita .cursor/mcp.json en tu proyecto):

{
  "mcpServers": {
    "google-maps": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/<your-username>/gmaps-mcp.git",
        "gmaps-mcp"
      ]
    }
  }
}

3. Cline (extensión de VS Code)

En la configuración de Cline (cline_mcp_settings.json):

{
  "mcpServers": {
    "google-maps": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/<your-username>/gmaps-mcp.git",
        "gmaps-mcp"
      ]
    }
  }
}

🧰 Herramientas disponibles

1. search_google_maps

Busca en Google Maps negocios, atracciones, servicios y lugares emblemáticos.

Parámetro

Tipo

Por defecto

Descripción

query

string

(obligatorio)

Término de búsqueda (p. ej., "coffee in Koramangala Bangalore", "dentists near Connaught Place Delhi", "Italian restaurants in New York").

limit

integer

10

Número máximo de resultados a devolver (1 a 50).

country

string

"in"

Código de país ISO de dos letras para la localización regional (p. ej., "in", "us", "gb", "de", "fr", "ae").

language

string

"en"

Código de idioma para los resultados (p. ej., "en", "hi", "es", "fr").

Estructura de salida

{
  "query": "coffee in Koramangala Bangalore",
  "country": "in",
  "language": "en",
  "total_results": 2,
  "places": [
    {
      "place_id": "ChIJ80IECk8UrjsRqCffDjE09lw",
      "name": "Dyu Art Cafe",
      "category": "Art cafe",
      "address": "KHB MIG Colony, 1st Cross Rd, Koramangala 8th Block, Bengaluru, Karnataka 560095",
      "phone": "096113 19774",
      "international_phone": "+91 96113 19774",
      "website": "http://www.dyuartcafe.com/",
      "domain": "dyuartcafe.com",
      "latitude": 12.9373076,
      "longitude": 77.6176544,
      "rating": 4.4,
      "review_count": 21440,
      "google_maps_url": "https://www.google.com/maps/place/?q=place_id:ChIJ80IECk8UrjsRqCffDjE09lw"
    }
  ]
}

2. get_place_details

Recupera información detallada de un lugar o negocio concreto mediante su ID de lugar o nombre.

Parámetro

Tipo

Por defecto

Descripción

place

string

(obligatorio)

ID de lugar de Google (p. ej., "ChIJ12k5kG_iDDkRwuzibQwYZ4M") o nombre exacto de negocio/lugar emblemático (p. ej., "AIIMS New Delhi").

country

string

"in"

Código de país ISO de dos letras (predeterminado: "in").

language

string

"en"

Código de idioma para la respuesta (predeterminado: "en").

🌐 Despliegue remoto (Streamable HTTP)

El servidor es compatible con el transporte Streamable HTTP moderno para su despliegue detrás de proxies inversos o en alojamiento en la nube:

# Start Streamable HTTP server on port 8000
uv run gmaps-mcp --transport streamable-http --host 0.0.0.0 --port 8000

El endpoint de MCP estará disponible en: http://<host>:8000/mcp

🧪 Desarrollo y pruebas

Ejecuta las pruebas unitarias y de integración usando uv:

# Run pytest test suite
uv run --with pytest --with pytest-asyncio pytest tests/ -v

# Run the server locally with debug logs
uv run gmaps-mcp --log-level DEBUG

📦 Estructura del proyecto

gmap-mcp/
├── pyproject.toml              # Packaging & dependencies (PEP 517/621)
├── README.md                   # Setup guide and MCP client docs
├── src/
│   └── gmaps_mcp/
│       ├── __init__.py         # Package entry
│       ├── schemas.py          # Pydantic data models (Place, Search, Details)
│       ├── server.py           # MCPServer instance & CLI runner
│       ├── tools.py            # MCP Tool definitions & detailed descriptions
│       └── scraper/
│           ├── __init__.py     # Scraper API
│           └── crawler.py      # Async Google Maps parser & extraction engine
└── tests/
    ├── test_schemas.py         # Schema tests
    ├── test_crawler.py         # Parser unit tests
    └── test_server.py          # MCP Server registration & tool calling tests

📜 Atribución y licencia

  • Núcleo del scraper adaptado y modularizado a partir de christivn/mapScraper (commit 1b38cf3e153294e3dad2f6cb5862be0201a54065).

  • Licenciado bajo la Licencia MIT.

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Google Maps Scraper

    Live Google Maps business search, review, and photo data for AI agents over MCP.

  • bizintel

    Local business intel for AI agents: audits, lead scoring, tech stack, prospecting.

  • Parallel Search MCP

    The best web search for your AI Agent

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/devsanthoshmk/gmaps-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server