MCP Reference: mapstools.googleapis.com

Сервер протокола контекста модели (MCP) выступает в качестве прокси-сервера между внешним сервисом, предоставляющим контекст, данные или возможности для приложения LLM или ИИ. Серверы MCP подключают приложения ИИ к внешним системам, таким как базы данных и веб-сервисы, переводя их ответы в формат, понятный ИИ-приложению.

Это MCP-сервер, предоставляемый API Maps Grounding Lite. Сервер предоставляет разработчикам инструменты для создания приложений LLM на платформе Google Карт.

Конечные точки сервера

Конечная точка сервиса MCP — это сетевой адрес и коммуникационный интерфейс (обычно URL) сервера MCP, который приложение ИИ (хост для клиента MCP) использует для установления безопасного стандартизированного соединения. Это точка контакта для уровня магистратуры (LLM) для запроса контекста, вызова инструмента или доступа к ресурсу. Конечные точки Google MCP могут быть глобальными или региональными.

Сервер MCP mapstools.googleapis.com имеет следующую конечную точку MCP:

Инструменты MCP

Инструмент MCP — это функция или исполняемая возможность, которую сервер MCP предоставляет приложению LLM или AI для выполнения действия в реальном мире.

Сервер MCP mapstools.googleapis.com имеет следующие инструменты:

Инструменты MCP
поиск_мест

Вызывайте этот инструмент, когда пользователь запрашивает поиск мест, предприятий, адресов, местоположений, точек интереса или любого другого поиска, связанного с Google Картами.

Входные требования (КРИТИЧНЫЕ):

  1. text_query (string - ОБЯЗАТЕЛЬНО): Основной поисковый запрос. Он должен чётко определять, что ищет пользователь.

    • Примеры: 'restaurants in New York' , 'coffee shops near Golden Gate Park' , 'SF MoMA' , '1600 Amphitheatre Pkwy, Mountain View, CA, USA' , 'pets friendly parks in Manhattan, New York' , 'date night restaurants in Chicago' , 'accessible public libraries in Los Angeles' .
    • Для получения подробной информации о конкретном месте: включите требуемый атрибут (например, 'Google Store Mountain View opening hours' , 'SF MoMa phone number' , 'Shoreline Park Mountain View address' ).

  2. location_bias (объект — НЕОБЯЗАТЕЛЬНО): используйте это, чтобы отдать приоритет результатам, находящимся вблизи определенной географической области.

    • Формат: {"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
    • Использование:
      • Для смещения к радиусу 5 км: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
      • Чтобы сильно сместиться к центральной точке: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (исключая radius_meters ).

  3. language_code (строка - НЕОБЯЗАТЕЛЬНО): Язык, на котором будет отображаться сводка результатов поиска.

    • Формат: двухбуквенный код языка (ISO 639-1), за которым может следовать символ подчеркивания и двухбуквенный код страны (ISO 3166-1 alpha-2), например, en , ja , en_US , zh_CN , es_MX . Если код языка не указан, результаты будут на английском языке.

  4. region_code (строка — НЕОБЯЗАТЕЛЬНО): код региона Unicode CLDR пользователя. Этот параметр используется для отображения информации о месте, например, названия региона, если оно доступно. Этот параметр может влиять на результаты в зависимости от действующего законодательства.

    • Формат: двухбуквенный код страны (ISO 3166-1 alpha-2), например, US , CA

Инструкции по вызову инструмента:

  • Информация о местоположении (КРИТИЧНО): Поиск должен содержать достаточно информации о местоположении. Если местоположение неоднозначно (например, просто «пиццерии»), необходимо указать его в text_query (например, «пиццерии в Нью-Йорке») или использовать параметр location_bias . При необходимости укажите название города, штата/провинции и региона/страны для устранения неоднозначности.

  • Всегда предоставляйте максимально конкретный и контекстно насыщенный text_query .

  • Используйте location_bias только в том случае, если координаты указаны явно или если определение местоположения из известного контекста пользователя целесообразно и необходимо для достижения наилучших результатов.

lookup_weather

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

Доступны конкретные данные: температура (текущая, по ощущениям, макс./мин., тепловой индекс), ветер (скорость, порывы, направление), небесные явления (восход/закат, фаза Луны), осадки (тип, вероятность, количество/QPF), атмосферные условия (УФ-индекс, влажность, облачность, вероятность грозы) и геокодированный адрес местоположения.

Входные требования (КРИТИЧНЫЕ):

  • Текущие условия: требуется только местоположение (например, город или адрес). Не указывайте дату или время.

  • Почасовой прогноз: требуется указать местоположение и час (0–23). Используйте, если пользователь спрашивает о погоде на определённое время или использует такие выражения, как «в ближайшие несколько часов» или «позже сегодня».

  • Ежедневные прогнозы: требуется указать местоположение и точную дату.

Обработка дат (КРИТИЧНО): Указанные пользователем даты и время ДОЛЖНЫ быть указаны в часовом поясе запрашиваемого местоположения. Даты ДОЛЖНЫ быть разбиты на отдельные целочисленные параметры: год, месяц и день. Обязательный формат этих параметров: {"year": , "месяц": , "день": }

compute_routes

Рассчитывает маршрут между указанной начальной и конечной точкой. Поддерживаемые режимы движения: АВТОМОБИЛЬ (по умолчанию), ПЕШКОМ.

Требования к вводу (КРИТИЧНЫЕ): необходимо указать как пункт отправления , так и пункт назначения . Каждый пункт должен быть указан одним из следующих способов, вложенных в соответствующее поле:

  • Адрес: (строка, например, «Эйфелева башня, Париж»). Примечание: чем более подробным или конкретным будет введённый адрес, тем лучше будут результаты.

  • lat_lng: (объект, {"широта": число, "долгота": число})

  • place_id: (строка, например, 'ChIJOwE_Id1w5EAR4Q27FkL6T_0') Примечание: этот идентификатор можно получить с помощью инструмента search_places. Допускается любая комбинация типов ввода (например, отправная точка по адресу, пункт назначения по широте и долготе). Если отправная точка или пункт назначения отсутствуют, ОБЯЗАТЕЛЬНО запросите у пользователя разъяснения, прежде чем пытаться вызвать инструмент.

Пример вызова инструмента: {"origin":{"address":"Эйфелева башня"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}