mcp-google-map MCP — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

14 atomic tools: geocode, reverse-geocode, directions, distance-matrix, places-search, place-details, elevation, timezone, weather, air-quality, static-maps, and more
4 composite tools for one-shot exploration, routing, comparison, and SEO rank-tracking
Tool subset filtering via GOOGLE_MAPS_ENABLED_TOOLS — trim context cost
stdio / HTTP / CLI transports
Runs with npx @cablate/mcp-google-map

Живое демо

Как выглядит на практике

google-map.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "google-map": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-map"
      ],
      "_inferred": true
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "google-map": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-map"
      ],
      "_inferred": true
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "google-map": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-map"
      ],
      "_inferred": true
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "google-map": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-map"
      ],
      "_inferred": true
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "google-map",
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-map"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "google-map": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-google-map"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add google-map -- npx -y mcp-google-map

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: mcp-google-map

Track your Google Maps ranking for key searches across zip codes

👤 Local SEO specialists, restaurant / service businesses ⏱ ~20 min intermediate

Когда использовать: You want to know where your business ranks for 'best pizza' in 20 zip codes around town, refreshed weekly.

Предварительные требования

Google Maps API key with Places (New) enabled — Google Cloud Console > Enable APIs

Поток

Use the composite local-rank-tracker tool

Run local-rank-tracker for business 'Tony's Pizza' (place_id: [id]) on query 'pizza near me' across these 20 coordinates [list lat/lng].✓ Скопировано

→ Per-location rank (or 'not in top 20')
Store history

Save results to ./rank-history/YYYY-MM-DD.json. Diff against last week.✓ Скопировано

→ Week-over-week delta

Итог: Weekly local rank report without paying a SaaS SEO tool.

Подводные камни

Google's Places API cost adds up — ~$17 per 1000 calls — Batch the locations; limit to key zip codes; cache for 7 days

Сочетать с: filesystem

Plan a multi-stop day trip with driving time and elevation

👤 Travelers, travel bloggers ⏱ ~10 min beginner

Когда использовать: Planning a road trip and want optimized stop order + realistic drive times.

Поток

Describe the stops

I want to visit Yosemite Valley, Mariposa Grove, Tunnel View, Glacier Point — in one day starting from Merced. Optimize the order and give drive times.✓ Скопировано

→ Ordered stops + per-leg drive minutes
Add context

For each stop, get elevation and the current weather.✓ Скопировано

→ Annotated itinerary

Итог: A sane itinerary with real-world durations.

Подводные камни

Routes API uses traffic-aware estimates only at query time — Re-query the morning of the trip for realistic drive times

Compare candidate locations for a new retail store

👤 Real estate analysts, franchise planners ⏱ ~30 min intermediate

Когда использовать: You're deciding between 3 candidate addresses for a new storefront. Foot traffic, competitor proximity, demographic proxies matter.

Поток

Reverse-geocode each candidate

For these 3 addresses, get coordinates and neighborhood.✓ Скопировано

→ 3 geocoded results
Use compare-places

For each location, count competitors within 1km (category: coffee shop). List top 10 nearby businesses.✓ Скопировано

→ Per-site competitive density + anchor tenants
Assess traffic corridors

For each, get drive-time from the nearest highway exit and major residential zip code.✓ Скопировано

→ Accessibility score

Итог: Data-backed site recommendation you can defend in a meeting.

Подводные камни

Google Places is not a substitute for actual foot-traffic data — Use as a first-pass filter; combine with Placer.ai or county permit data for final decision

Комбинации

Сочетайте с другими MCP — эффект x10

google-map + filesystem

Store weekly rank-tracker snapshots to disk, diff over time

Run local-rank-tracker for my business, save to /reports/rank/YYYY-MM-DD.json.✓ Скопировано

google-map + postgres

Enrich customer addresses in your DB with lat/lng for map dashboards

For each row in customers where lat IS NULL, geocode the address and UPDATE with lat/lng. Stop at 500/day to respect quota.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
geocode	address: str	Address → coordinates	$5 / 1000 calls
reverse_geocode	lat, lng	Coordinates → address	$5 / 1000
directions	origin, destination, mode?, waypoints?	Turn-by-turn or drive-time	$5-10 / 1000
places_search	query, location?, radius?	Find businesses by keyword near a point	$17-32 / 1000 (New Places)
place_details	place_id	After places_search to get hours, phone, website	$17+ / 1000
explore-area	center, radius, categories[]	Composite — one shot neighborhood survey	bundled
plan-route	stops[], mode, optimize?: bool	Multi-stop trip planning	bundled
compare-places	places[], categories[]	Site selection or evaluation	bundled
local-rank-tracker	query, place_id, locations[]	Local SEO audits	N * places_search cost

Стоимость и лимиты

Во что обходится

Квота API: Google: $200/mo free credit covers ~12k geocodes or ~10k Places (New) Autocomplete/Details
Токенов на вызов: Tool results 500-3000 tokens; trim via GOOGLE_MAPS_ENABLED_TOOLS to reduce schema overhead
Деньги: Pay Google directly. See cloud.google.com/maps-platform/pricing.
Совет: Places (New) is the expensive one. Use geocode (cheap) when you just need coordinates, not business data. Cache place_id aggressively.

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: Enable only the APIs you actually use

Хранение учётных данных: GOOGLE_MAPS_API_KEY env var. Restrict the key to your IP / referrer.

Исходящий трафик: All queries to maps.googleapis.com

Никогда не давайте: Unrestricted key on a shared machine — anyone can burn your quota

Google bills monthly — set a budget alert in GCP Billing before enabling APIs.
Places (New) supersedes legacy Places; make sure you enabled the (New) version.

Устранение неполадок

Частые ошибки и исправления

REQUEST_DENIED / API key not valid

API isn't enabled or key restrictions block your IP. Check GCP Console > APIs & Services > Credentials.

Проверить: curl 'https://maps.googleapis.com/maps/api/geocode/json?address=NYC&key=$KEY'

OVER_QUERY_LIMIT

You've blown the $200 monthly free tier, or Google is throttling per-second. Back off + batch.

Проверить: GCP Billing > Reports

Empty results for obvious queries

Places (New) requires explicit field masks on some calls. Update to latest npm version.

Альтернативы

mcp-google-map в сравнении

Альтернатива	Когда использовать	Компромисс
OpenStreetMap Nominatim MCP	Free, no API key, non-commercial use OK	Less rich data; rate-limited to 1 rps
Mapbox MCP	You prefer Mapbox's styling and routing	Different pricing and data model

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills