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

Ein eigenständiger, leichter Google Maps Model Context Protocol (MCP)-Server, erstellt mit dem offiziellen MCP Python SDK. Er bietet KI-Agenten (wie Claude Desktop, Cursor, Cline und Antigravity) strukturierte Suchergebnisse, Ortsdetails, Bewertungen, Kontaktinformationen, Koordinaten und Google Maps-URLs.

⚡ Hauptfunktionen

  • Ein-Kommando-Installation: Läuft überall sofort via uvx, ohne manuelle Umgebungseinrichtung.

  • 100% eigenständig: Die Scraper-Engine ist nativ prozessintern über asyncio und aiohttp integriert – keine externen Unterprozesse, Headless-Browser oder API-Schlüssel erforderlich.

  • Reichhaltige strukturierte Ortsdaten: Gibt Orts-IDs, Geschäftsnamen, Kategorien, Adressen, lokale und internationale Telefonnummern, Website-URLs, Koordinaten (lat/long), Sternebewertungen, Anzahl der Bewertungen und direkte Google Maps-Links zurück.

  • Stdio & Streamable HTTP: Native stdio-Unterstützung für Desktop-KI-Clients und streamable-http für Remote-/Container-Bereitstellungen.

  • Sauberes JSON-RPC: Die gesamte interne Protokollierung erfolgt strikt über stderr, sodass der stdio-Protokollstrom zu 100% konform bleibt.

Related MCP server: Google Maps MCP Server

🚀 Schnellstart

Führen Sie es direkt mit uvx aus:

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

Oder aus einem lokalen Klon:

uv run gmaps-mcp

🛠️ MCP-Client-Konfiguration

1. Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu (~/Library/Application Support/Claude/claude_desktop_config.json auf macOS oder %APPDATA%\Claude\claude_desktop_config.json auf Windows):

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

Wenn Sie es aus einem lokalen Ordner ausführen:

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

2. Cursor IDE

Öffnen Sie in Cursor Einstellungen → Features → MCP (oder bearbeiten Sie .cursor/mcp.json in Ihrem Projekt):

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

3. Cline (VS Code-Erweiterung)

In den Cline-Einstellungen (cline_mcp_settings.json):

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

🧰 Verfügbare Werkzeuge

1. search_google_maps

Durchsuchen Sie Google Maps nach Unternehmen, Sehenswürdigkeiten, Dienstleistungen und Wahrzeichen.

Parameter

Typ

Standard

Beschreibung

query

string

(erforderlich)

Suchbegriff (z.B. "café in Koramangala Bangalore", "Zahnärzte in der Nähe von Connaught Place Delhi", "Italienische Restaurants in New York").

limit

integer

10

Maximale Anzahl der zurückzugebenden Ergebnisse (1 bis 50).

country

string

"in"

Zweibuchstabiger ISO-Ländercode für die Regionallokalisierung (z.B. "in", "us", "gb", "de", "fr", "ae").

language

string

"en"

Sprachcode für die Ergebnisse (z.B. "en", "de", "es", "fr").

Ausgabestruktur

{
  "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

Rufen Sie detaillierte Informationen zu einem einzelnen Ort oder Unternehmen anhand seiner Orts-ID oder seines Namens ab.

Parameter

Typ

Standard

Beschreibung

place

string

(erforderlich)

Google-Orts-ID (z.B. "ChIJ12k5kG_iDDkRwuzibQwYZ4M") oder genauer Geschäfts-/Wahrzeichenname (z.B. "AIIMS Neu-Delhi").

country

string

"in"

Zweibuchstabiger ISO-Ländercode (Standard: "in").

language

string

"en"

Sprachcode für die Antwort (Standard: "en").

🌐 Remote-Bereitstellung (Streamable HTTP)

Der Server unterstützt modernes Streamable HTTP-Transport für die Bereitstellung hinter Reverse-Proxys oder Cloud-Hosting:

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

Der MCP-Endpunkt ist verfügbar unter: http://<host>:8000/mcp

🧪 Entwicklung & Testen

Führen Sie Unit- und Integrationstests mit uv aus:

# 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

📦 Projektstruktur

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

📜 Quellenangabe & Lizenz

  • Scraper-Kern adaptiert und modularisiert von christivn/mapScraper (Commit 1b38cf3e153294e3dad2f6cb5862be0201a54065).

  • Lizenziert unter der MIT-Lizenz.

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