cablate/mcp-google-map

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

487 stars 94 forks Качество 88 Тренд 36MIT

Мощный сервер Model Context Protocol (MCP), обеспечивающий комплексную интеграцию API Google Maps с возможностями обработки LLM.

Обзор

Дайте вашему агенту ИИ возможность понимать физический мир — геокод, маршрут, поиск и логику о местоположении. - — 14 атомарных + 4 композитных (область-исследование, план-маршрут, сравнение мест, локальный трекер ранга) - — stdio, StreamableHTTP, отдельный исполнительный CLI - — встроенное определение навыков учит ИИ цепочке гео-инструментов (навыки/google-maps/) Особая благодарность @junyinnnn за помощь в добавлении поддержки streamablehttp. Все инструменты имеют аннотации readOnlyHint: true и destructiveHint: false — клиенты MCP могут автоматически одобрять их без подтверждения пользователя. : Включите и включите в Google Cloud Console перед использованием инструментов, связанных с местом и маршрутизацией. Работает с Claude Desktop, Cursor, VS Code и любым MCP-клиентом, поддерживающим stdio: — Если вам нужен только поднабор инструментов, установите GOOGLE_MAPS_ENABLED_TOOLS так, чтобы ограничить, какие инструменты регистрируются: Опустите или установите * для всех 18 инструментов (по умолчанию).

Обзор (машинный перевод)

Прекратите перестраивать рабочие процессы поиска, маршрутизации и местоположения для каждого AI-приложения.

@cablate/mcp-google-map превращает платформу Google Maps в 18 инструментов агентов только для чтения и три специализированных навыка. Агент может находить реальные места, проверять маршруты, сравнивать варианты, строить практические маршруты или проверять видимость локального поиска — через MCP или отдельный CLI.

Вы выбираете модель интеграции: Codex или плагин Claude Code, когда нужен Skills без настройки MCP, stdio для настольных MCP-клиентов или Streamable HTTP для совместных и удалённых развертываний.

Английский · 繁體中文

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

Предоставление агенту сырого API Maps — это только начало. Полезные ответы часто требуют нескольких зависимых вызовов: определить место, сохранить его идентичность, поиск вокруг него, проверить детали открытия, рассчитать время в пути и объяснить, что именно было проверено. Этот проект объединяет это в единый согласованный интерфейс.

Переход от lookup к результату. Atomic Tools занимаются геокодированием, деталями размещения, направлениями, погодой, качеством воздуха и картами. Композитные инструменты исследуют районы, сравнивают кандидатов, оптимизируют остановки и измеряют локальные рейтинги.
**Используйте те же возможности с MCP или без него.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Google Maps for AI agents

Stop rebuilding place search, routing, and location workflows for every AI app.

@cablate/mcp-google-map turns Google Maps Platform into 18 read-only agent tools and three focused Skills. An agent can find real places, verify routes, compare options, build practical itineraries, or audit local search visibility—through MCP or a standalone CLI.

You choose the integration model: Codex or Claude Code Plugin when you want Skills without MCP setup, stdio for desktop MCP clients, or Streamable HTTP for shared and remote deployments.

English · 繁體中文

Why use it?

Giving an agent a raw Maps API is only the beginning. Useful answers often require several dependent calls: resolve a place, preserve its identity, search around it, check opening details, calculate travel time, and explain what was actually verified. This project packages that work into one consistent interface.

Move from lookup to outcome. Atomic tools handle geocoding, place details, directions, weather, air quality, and maps. Composite tools explore areas, compare candidates, optimize stops, and measure local rankings.
Use the same capabilities with or without MCP. The standalone exec CLI works with Agent Skills and automation; the MCP server exposes the same 18 tools over stdio or HTTP.
Give agents workflow guidance, not just function names. Three Skills cover general map research, evidence-backed travel planning, and local SEO. Codex loads their full instructions only when a request matches.
Keep deployment and credentials under your control. Run locally or self-host. API keys remain in your environment or request headers, with per-session isolation for HTTP deployments.
Start narrow and grow later. Register only the tools you need with GOOGLE_MAPS_ENABLED_TOOLS, or use the full catalog.

What can an agent do?

Outcome	How the project helps

Открыть полный README на GitHub

Установка

npx -y @cablate/mcp-google-map --stdio

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "google-maps": {
      "command": "npx",
      "args": ["-y", "@cablate/mcp-google-map", "--stdio"],
      "env": { "GOOGLE_MAPS_API_KEY": "YOUR_API_KEY" }
    }
  }
}