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 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit

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

點擊 Cline 側欄中的 MCP Servers 圖示，然後選 "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 使用伺服器物件陣列，而非映射。

~/.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 搭配，撬動十倍槓桿

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
每次呼叫 Token 數: 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

mcp-google-map

為什麼要用

核心特性

即時演示

實際使用效果

安裝

選擇你的客戶端

使用場景

實戰用法： mcp-google-map

Track your Google Maps ranking for key searches across zip codes

前置條件

步驟

注意事項

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

步驟

注意事項

Compare candidate locations for a new retail store

步驟

注意事項

組合

與其他 MCP 搭配，撬動十倍槓桿

工具

此 MCP 暴露的能力

成本與限制

運行它的成本

安全

權限、密鑰、影響範圍

故障排查

常見錯誤與修復

替代方案

mcp-google-map 對比其他方案

更多

資源