MCP Tools Reference: mapstools.googleapis.com

Справочник по инструментам MCP:

В этом документе описываются внешние конечные точки REST API, используемые для вызова инструментов Google Remote Model Context Protocol (MCP). Этот API действует как безопасный прокси-сервер между внешним HTTP-клиентом (например, curl или веб-сервисом) и внутренним сервером MCP.

Получить характеристики инструмента MCP

Чтобы получить спецификации инструментов MCP для всех инструментов на сервере MCP, используйте метод `tools/list`. В следующем примере показано, как использовать curl для получения списка всех инструментов и их спецификаций, доступных в настоящее время на сервере MCP.

Запрос Curl 
curl --location 'https://mapstools.googleapis.com/mcp'
--header 'content-type: application/json'
--header 'accept: application/json, text/event-stream'
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'

Инструмент: search_places

Вызывайте этот инструмент, когда пользователь запрашивает поиск мест, предприятий, адресов, местоположений, точек интереса или любого другого поиска, связанного с 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 только в том случае, если координаты указаны явно или если определение местоположения из известного контекста пользователя целесообразно и необходимо для достижения наилучших результатов.

В следующих примерах показано, как использовать curl для вызова инструмента MCP search_places.

Запрос Curl 
curl --location 'https://mapstools.googleapis.com/mcp'
--header 'content-type: application/json'
--header 'accept: application/json, text/event-stream'
--data '{
  "method": "tools/call",
  "params": {
    "name": search_places,
    arguments: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Инструмент: lookup_weather

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

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

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

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

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

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

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

В следующих примерах показано, как использовать curl для вызова инструмента MCP lookup_weather.

Запрос Curl 
curl --location 'https://mapstools.googleapis.com/mcp'
--header 'content-type: application/json'
--header 'accept: application/json, text/event-stream'
--data '{
  "method": "tools/call",
  "params": {
    "name": lookup_weather,
    arguments: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Инструмент: compute_routes

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

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

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

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

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

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

В следующих примерах показано, как использовать curl для вызова инструмента MCP compute_routes.

Запрос Curl 
curl --location 'https://mapstools.googleapis.com/mcp'
--header 'content-type: application/json'
--header 'accept: application/json, text/event-stream'
--data '{
  "method": "tools/call",
  "params": {
    "name": compute_routes,
    arguments: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'