cablate/mcp-google-map

cablate/mcp-google-map

от cablate
MCP-сервер, который подключает AI-агента к Google Maps — геокодирование, поиск мест, маршруты, погода и качество воздуха. Включает 18 инструментов, включая составные для планирования поездок и сравнения мест. Полезен разработчикам AI-ассистентов для навигации и анализа местности.

npm version npm downloads GitHub stars license

MCP Google Maps — AI-Powered Geospatial Tools

Give your AI agent the ability to understand the physical world —
geocode, route, search, and reason about locations.

English | 繁體中文

Travel planning demo — Kyoto 2-day, Tokyo outdoor, Japan 5-day, Bangkok budget

  • 18 tools — 14 atomic + 4 composite (explore-area, plan-route, compare-places, local-rank-tracker)
  • 3 modes — stdio, StreamableHTTP, standalone exec CLI
  • Agent Skill — built-in skill definition teaches AI how to chain geo tools (skills/google-maps/)
vs Google Grounding Lite
This project Grounding Lite
Tools 18 3
Geocoding Yes No
Step-by-step directions Yes No
Elevation Yes No
Distance matrix Yes No
Place details Yes No
Timezone Yes No
Weather Yes Yes
Air quality Yes No
Map images Yes No
Composite tools (explore, plan, compare) Yes No
Open source MIT No
Self-hosted Yes Google-managed only
Agent Skill Yes No
Quick Start
# stdio (Claude Desktop, Cursor, etc.)
npx @cablate/mcp-google-map --stdio

# exec CLI — no server needed
npx @cablate/mcp-google-map exec geocode '{"address":"Tokyo Tower"}'

# HTTP server
npx @cablate/mcp-google-map --port 3000 --apikey "YOUR_API_KEY"
Инструменты были проиндексированы:
maps_air_qualityтолько чтениеидемпотентныйвнешний мир

Получает качество воздуха для местоположения — индекс AQI, концентрации загрязнителей и рекомендации по здоровью для разных групп населения (пожилые, дети, спортсмены, беременные и т.д.). Используйте, когда пользователь спрашивает «безопасен ли воздух», «стоит ли носить маску», «хорошо ли для занятий на улице» или планирует поездку для человека с проблемами дыхания или сердца. Покрытие: глобальное, включая Японию (в отличие от погоды). Возвращает как универсальный AQI, так и локальный индекс (EPA для США, AEROS для Японии и т.д.).

Параметры
  • includeHealthRecommendationsboolean

    Include health advice per demographic group (default: true)

  • includePollutantsboolean

    Include individual pollutant concentrations — PM2.5, PM10, NO2, O3, CO, SO2 (default: false)

  • latitudenumberобязательный

    Latitude coordinate

  • longitudenumberобязательный

    Longitude coordinate

maps_batch_geocodeтолько чтениеидемпотентныйвнешний мир

Геокодирует несколько адресов за один вызов — до 50 адресов, возвращает координаты каждого. Используйте, когда пользователь передаёт список адресов и нужны координаты всех, например «геокодируй эти 10 офисов» или «получи координаты для всех этих ресторанов». Если адресов больше 50, используйте вместо этого команду CLI batch-geocode.

Параметры
  • addressesstring[]обязательный

    List of addresses or landmark names to geocode (max 50)

maps_compare_placesтолько чтениеидемпотентныйвнешний мир

Сравнивает несколько мест бок о бок за один вызов: ищет по запросу, получает детали по каждому результату и опционально вычисляет расстояние от вашего местоположения. Используйте, когда пользователь спрашивает «какой ресторан выбрать», «сравните эти отели» или просит таблицу для принятия решений. Заменяет ручную цепочку search-places → place-details → distance-matrix.

Параметры
  • limitnumber

    Max places to compare (default: 5)

  • querystringобязательный

    Search query (e.g., 'ramen near Shibuya', 'hotels in Taipei')

  • userLocationobject

    Your current location — if provided, adds distance and drive time to each result

maps_directionsтолько чтениеидемпотентныйвнешний мир

Получает пошаговые инструкции по навигации между двумя точками с деталями маршрута. Используйте, когда пользователь спрашивает «как добраться из A в B?» и нужна сводка маршрута, общее расстояние, расчетное время в пути или пошаговые инструкции. Поддерживает время отправления/прибытия и несколько режимов передвижения.

Параметры
  • arrival_timestring

    Arrival time (ISO string format)

  • avoid_highwaysboolean

    Avoid highways where reasonable. Only supported with mode "driving".

  • avoid_tollsboolean

    Avoid toll roads where reasonable. Only supported with mode "driving".

  • departure_timestring

    Departure time (ISO string format)

  • destinationstringобязательный

    Destination address or coordinates

  • modeenum

    Travel mode for directions

  • originstringобязательный

    Starting point address or coordinates

maps_distance_matrixтолько чтениеидемпотентныйвнешний мир

Рассчитывает расстояния и время в пути между несколькими точками отправления и назначения в одном запросе. Используйте для сравнения вариантов поездки, например, «какая гостиница ближе всего к офису?» или пакетных расчетов расстояний. Поддерживает режимы передвижения: на автомобиле, пешком, на велосипеде и общественным транспортом.

Параметры
  • avoid_highwaysboolean

    Avoid highways where reasonable. Only supported with mode "driving".

  • avoid_tollsboolean

    Avoid toll roads where reasonable. Only supported with mode "driving".

  • departure_timestring

    Departure time in ISO 8601 format (e.g. 2026-03-21T09:00:00Z). Enables traffic-aware duration estimates.

  • destinationsstring[]обязательный

    List of destination addresses or coordinates

  • modeenum

    Travel mode for calculation

  • originsstring[]обязательный

    List of origin addresses or coordinates

maps_elevationтолько чтениеидемпотентныйвнешний мир

Получает высоту над уровнем моря для географических координат. Используйте, когда пользователь спрашивает «какая высота у этого места», «подвержена ли эта местность наводнениям» или нужна высота для профилей пеших или велосипедных маршрутов. Также пригодится для оценки рисков недвижимости — низкая высота рядом с водой указывает на риск наводнения.

Параметры
  • locationsobject[]обязательный

    List of locations to get elevation data for

maps_explore_areaтолько чтениеидемпотентныйвнешний мир

Исследует окрестности одной командой — ищет по нескольким типам мест, получает подробности по лучшим результатам и возвращает категоризированную сводку. Используй, когда пользователь спрашивает «что здесь рядом», «изучи район рядом с моим отелем» или хочет быстро понять, что за место. Заменяет ручную цепочку geocode → search-nearby → place-details. Для планирования поездки: сначала используй search_places, чтобы получить географически разнесённые точки, потом вызывай этот инструмент около каждой точки (например, «Гион, Киото») — никогда не передавай просто название города, иначе все результаты соберутся в одном месте. После результатов вызывай static_map для визуализации.

Параметры
  • locationstringобязательный

    Address or landmark to explore around

  • radiusnumber

    Search radius in meters (default: 1000)

  • topNnumber

    Number of top results per type to get details for (default: 3)

  • typesstring[]

    Place types to search (default: restaurant, cafe, tourist_attraction). Must be Places API (New) type names. Examples: hotel, bar, park, museum

maps_geocodeтолько чтениеидемпотентныйвнешний мир

Преобразует адрес, название города или ориентир в GPS-координаты (широта/долгота). Используйте, когда нужны координаты для места, описанного в тексте - например, чтобы задать центр для search_nearby или начальную точку для maps_directions.

Параметры
  • addressstringобязательный

    Address or place name to convert to coordinates

maps_local_rank_trackerтолько чтениеидемпотентныйвнешний мир

Отслеживает рейтинг бизнеса в локальном поиске по географической сетке (как LocalFalcon). Выполняет поиск по одним и тем же ключевым словам из нескольких координат вокруг центральной точки, чтобы увидеть, как меняется позиция в зависимости от местоположения. Поддерживает до 3 ключевых слов для пакетного сканирования. Возвращает позицию в каждой точке сетки, топ-3 конкурентов по каждой точке и сводные метрики (ARP, ATRP, SoLV). Полезно для анализа локального SEO.

Параметры
  • centerobjectобязательный

    Center coordinate for the grid (typically the business location)

  • gridSizeinteger

    Grid dimension (3 = 3×3 = 9 points, 5 = 5×5 = 25 points, 7 = 7×7 = 49 points). Default: 3

  • gridSpacingnumber

    Distance between grid points in meters (100-10000). Default: 1000

  • keywordstring

    Single search keyword (e.g., 'dentist'). Use 'keywords' for multi-keyword scanning.

  • keywordsstring[]

    Array of 1-3 keywords to scan (e.g., ['dentist', 'dental clinic', 'teeth cleaning']). Overrides 'keyword'.

  • placeIdstringобязательный

    Google Maps place_id of the target business to track

maps_place_detailsтолько чтениеидемпотентныйвнешний мир

Получает подробную информацию о конкретном месте, используя его Google Maps place_id. Используйте после search_nearby или maps_search_places, чтобы получить полную информацию, включая отзывы, номер телефона, веб-сайт и часы работы. Задайте maxPhotos (1-10), чтобы включить URL-адреса фотографий — опустите или установите 0, если фотографии не нужны (экономит токены).

Параметры
  • maxPhotosinteger

    Number of photo URLs to include (0 = none, max 10). Omit to skip photos and save tokens.

  • placeIdstringобязательный

    Google Maps place ID

maps_plan_routeтолько чтениеидемпотентныйвнешний мир

Планирует оптимизированный маршрут с несколькими остановками за один вызов: геокодирует все остановки, использует оптимизацию путевых точек Routes API (до 25 промежуточных остановок) для поиска наиболее эффективного порядка посещения и возвращает маршрутные указания для каждого участка. Используйте, когда пользователь говорит «посети эти 5 мест эффективно», «проложи маршрут через A, B, C» или нуждается в многоостановочном маршруте. Заменяет ручную цепочку геокодирование → матрица расстояний → маршрутные указания. Для многодневных поездок: создавайте один вызов plan_route на каждый день с остановками, которые следуют географической дуге (например, с востока на запад), а не смешивают удалённые области. После получения результатов вызывайте static_map для визуализации маршрута.

Параметры
  • avoid_highwaysboolean

    Avoid highways where reasonable. Only supported with mode "driving".

  • avoid_tollsboolean

    Avoid toll roads where reasonable. Only supported with mode "driving".

  • departure_timestring

    Departure time in ISO 8601 format (e.g. 2026-03-21T09:00:00Z). Enables traffic-aware routing.

  • modeenum

    Travel mode (default: driving)

  • optimizeboolean

    Auto-optimize visit order via Routes API waypoint optimization (default: true). Set false to keep original order. Not available for transit mode.

  • stopsstring[]обязательный

    List of addresses or landmarks to visit (minimum 2)

maps_reverse_geocodeтолько чтениеидемпотентныйвнешний мир

Преобразует GPS-координаты (широту/долготу) в человекочитаемый почтовый адрес. Используйте, когда у вас есть координаты из вывода другого инструмента или переданная пользователем геопозиция, и нужен фактический адрес.

Параметры
  • latitudenumberобязательный

    Latitude coordinate

  • longitudenumberобязательный

    Longitude coordinate

maps_search_along_routeтолько чтениеидемпотентныйвнешний мир

Ищет места вдоль маршрута между двумя точками: рестораны, кафе, заправки и т.д., отсортированные по минимальному времени отклонения от маршрута. Используется для планирования поездки, чтобы находить еду, места отдыха или достопримечательности между ориентирами без возврата назад. Внутренне вычисляет маршрут, затем ищет вдоль него. Незаменим для построения маршрутов, где остановки должны ощущаться как «по пути», а не как «объезд».

Параметры
  • destinationstringобязательный

    Route end point — address or landmark name

  • maxResultsnumber

    Max results to return (default: 5, max: 20)

  • modeenum

    Travel mode for the route (default: walking)

  • originstringобязательный

    Route start point — address or landmark name

  • textQuerystringобязательный

    What to search for along the route (e.g. 'restaurant', 'coffee shop', 'temple')

maps_search_nearbyтолько чтениеидемпотентныйвнешний мир

Находит места рядом с указанным местоположением по типу (например, рестораны, кафе, отели). Используйте, когда пользователь хочет узнать, что находится рядом с заданным адресом или координатами — например, «найди кофейни рядом с Times Square» или «какие отели рядом с аэропортом». Поддерживает фильтрацию по типу места, радиусу поиска, минимальному рейтингу и по признаку «открыто сейчас».

Параметры
  • centerobjectобязательный

    Search center point (e.g. value: 49.3268778,-123.0585982, isCoordinates: true)

  • keywordstring

    Place type to search for (e.g., restaurant, cafe, hotel, gas_station, hospital)

  • minRatingnumber

    Minimum rating requirement (0-5)

  • openNowboolean

    Only show places that are currently open

  • radiusnumber

    Search radius in meters

maps_search_placesтолько чтениеидемпотентныйвнешний мир

Ищет места по свободному текстовому запросу, например 'sushi restaurants in Tokyo' или 'best coffee shops near Central Park'. Более гибкий, чем search_nearby — поддерживает запросы на естественном языке, опциональную привязку к местоположению, фильтры по рейтингу и фильтр «открыто сейчас». Используйте, когда пользователь описывает, что ищет, словами, а не по типу и координатам.

Параметры
  • includedTypestring

    Filter by place type (e.g., restaurant, cafe, hotel)

  • locationBiasobject

    Optional location to bias results toward

  • minRatingnumber

    Minimum rating filter (1.0 - 5.0)

  • openNowboolean

    Only return places that are currently open

  • querystringобязательный

    Text search query (e.g., 'Italian restaurants in Manhattan', 'hotels near Taipei 101')

maps_static_mapтолько чтениеидемпотентныйвнешний мир

Создает карту с маркерами, путями или маршрутами — результат возвращается в виде встроенного изображения, которое пользователь видит прямо в чате. ВЫЗЫВАЙ этот инструмент после explore_area, plan_route, search_nearby или directions, чтобы визуализировать результаты на карте — не жди, пока пользователь попросит. Используй маркеры из результатов поиска и путь из данных маршрута. Поддерживает режимы: дорожная карта, спутник, рельеф и гибрид. Максимум 640×640 пикселей.

Параметры
  • centerstring

    Map center — "lat,lng" or address. Optional if markers or path are provided.

  • maptypeenum

    Map style. Default: roadmap.

  • markersstring[]

    Marker descriptors. Each string: "color:red|label:A|lat,lng" or "color:blue|address". Multiple markers per string separated by |.

  • pathstring[]

    Path descriptors. Each string: "color:0x0000ff|weight:3|lat1,lng1|lat2,lng2|..." to draw lines/routes on the map.

  • sizestring

    Image size "WxH" in pixels. Default: "600x400". Max: "640x640".

  • zoomnumber

    Zoom level 0-21 (0 = world, 15 = streets, 21 = buildings). Default: auto-fit.

maps_timezoneтолько чтениеидемпотентныйвнешний мир

Получить часовой пояс и текущее местное время для местоположения. Используйте, когда пользователь спрашивает «сколько времени в Токио», нужно согласовать встречу в разных часовых поясах или планируется поездка через границы часовых поясов. Возвращает timezone ID, смещения UTC/DST и вычисленное местное время.

Параметры
  • latitudenumberобязательный

    Latitude coordinate

  • longitudenumberобязательный

    Longitude coordinate

  • timestampnumber

    Unix timestamp in ms to query timezone at a specific moment (defaults to now)

maps_weatherтолько чтениеидемпотентныйвнешний мир

Получает погоду для местоположения: текущие условия, дневной прогноз (10 дней) или почасовой прогноз (240 часов). Используйте, когда пользователь спрашивает «какая погода в Париже», планирует мероприятия на улице или собирает чемодан в поездку. Покрытие: поддерживается большинство регионов, но Китай, Япония, Южная Корея, Куба, Иран, Северная Корея, Сирия недоступны.

Параметры
  • forecastDaysnumber

    Number of forecast days (1-10, only for forecast_daily, default: 5)

  • forecastHoursnumber

    Number of forecast hours (1-240, only for forecast_hourly, default: 24)

  • latitudenumberобязательный

    Latitude coordinate

  • longitudenumberобязательный

    Longitude coordinate

  • typeenum

    current = right now, forecast_daily = multi-day outlook, forecast_hourly = hour-by-hour

Похожие MCP-сервера

skedgo/tripgo-mcp-server

skedgo/tripgo-mcp-server

MCP-сервер для интеграции с API TripGo: поиск транспортных локаций, отправлений и мультимодальное построение маршрутов. Полезен разработчикам ИИ-агентов для планирования поездок и анализа транспорта.

TypeScript5
haomingkoo/japan-seasons-mcp

haomingkoo/japan-seasons-mcp

MCP сервер с живыми данными о сезонах в Японии: прогнозы сакуры и осенних листьев, фруктовые пикники и фестивали, погода. Подойдёт путешественникам и гидам для планирования поездок по 1700+ локациям.

TypeScript1
Emanuele94/SimBrief-MCPServer

Emanuele94/SimBrief-MCPServer

MCP-сервер для Claude Desktop, дающий доступ к планам полётов SimBrief через 14 инструментов: сводка рейса, погода, топливо, веса, ATC-план, навлог и NOTAM. Всё работает без Cloudflare и OAuth — до...

Python1
pab1it0/tripadvisor-mcp

pab1it0/tripadvisor-mcp

MCP сервер для Tripadvisor: поиск отелей, ресторанов и достопримечательностей, получение отзывов и фото, а также определение мест поблизости. Инструмент для AI-ассистентов и разработчиков travel-решений.

Python64
vikramgorla/mcp-swiss

vikramgorla/mcp-swiss

MCP сервер для доступа к швейцарским открытым данным: транспорт, погода, компании - без API-ключей и регистрации. Включает 76 готовых инструментов для AI-ассистентов и разработчиков, с нулевой наст...

TypeScript22
forgemeshlabs/travel-mcp

forgemeshlabs/travel-mcp

MCP сервер для планирования путешествий без API-ключа: поиск аэропортов по коду IATA, сравнение маршрутов, подсказки по срокам вылета и сезонам, генерация внешних ссылок на бронирование. Полезен разработчикам и пользователям ИИ-агентов для быстрой оценки рейсов.

TypeScript1
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин