MCP Tools Reference: mapstools.googleapis.com

Dokumentacja narzędzi MCP:

W tym dokumencie opisujemy zewnętrzne punkty końcowe interfejsu REST API, które służą do wywoływania narzędzi protokołu kontekstu modelu zdalnego (MCP) Google. Ten interfejs API działa jako bezpieczny serwer proxy między zewnętrznym klientem HTTP (np. curl lub usługa internetowa) a wewnętrznym serwerem MCP.

Specyfikacje narzędzia MCP

Aby uzyskać specyfikacje narzędzi MCP dla wszystkich narzędzi na serwerze MCP, użyj metody `tools/list`. Poniższy przykład pokazuje, jak za pomocą polecenia curl wyświetlić listę wszystkich narzędzi i ich specyfikacji dostępnych obecnie na serwerze MCP.

Żądanie 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
}'

Narzędzie: search_places

Użyj tego narzędzia, gdy użytkownik chce znaleźć miejsca, firmy, adresy, lokalizacje, ciekawe miejsca lub inne informacje związane z Mapami Google.

Wymagania dotyczące danych wejściowych (KRYTYCZNE):

  1. text_query (ciąg znaków – OBOWIĄZKOWY): główne zapytanie. Musi on jasno określać, czego szuka użytkownik.

    • Przykłady: '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'.
    • Szczegóły konkretnego miejsca: podaj wymagany atrybut (np. 'Google Store Mountain View opening hours', 'SF MoMa phone number', 'Shoreline Park Mountain View address').

  2. location_bias (obiekt – OPCJONALNIE): użyj tego parametru, aby nadać priorytet wynikom w pobliżu określonego obszaru geograficznego.

    • Format: {"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
    • Użycie:
      • Aby ustawić preferencje na promień 5 km: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
      • Aby silnie faworyzować punkt środkowy: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (pomijając radius_meters).

  3. language_code (ciąg znaków – OPCJONALNIE): język, w którym ma być wyświetlane podsumowanie wyników wyszukiwania.

    • Format: dwuliterowy kod języka (ISO 639-1), opcjonalnie z podkreśleniem i dwuliterowym kodem kraju (ISO 3166-1 alpha-2), np. en, ja, en_US, zh_CN, es_MX. Jeśli nie podasz kodu języka, wyniki będą wyświetlane w języku angielskim.

  4. region_code (ciąg znaków – OPCJONALNY): kod regionu CLDR użytkownika w formacie Unicode. Ten parametr służy do wyświetlania szczegółów miejsca, np. nazwy miejsca w danym regionie, jeśli jest dostępna. W zależności od obowiązujących przepisów parametr może wpływać na wyniki.

    • Format: dwuliterowy kod kraju (ISO 3166-1 alfa-2), np. US, CA.

Instrukcje dotyczące wywołania narzędzia:

  • Informacje o lokalizacji (KRYTYCZNE): wyszukiwanie musi zawierać wystarczające informacje o lokalizacji. Jeśli lokalizacja jest niejednoznaczna (np. tylko „pizzerie”), musisz ją określić w parametrze text_query (np. „pizzerie w Nowym Jorku”) lub użyj parametru location_bias. W razie potrzeby podaj nazwę miasta, stanu/prowincji i regionu/kraju, aby uniknąć niejednoznaczności.

  • Zawsze podawaj jak najbardziej szczegółowe i bogate w kontekst text_query.

  • Używaj tylko location_bias, jeśli współrzędne są wyraźnie podane lub jeśli wywnioskowanie lokalizacji z kontekstu znanego użytkownikowi jest odpowiednie i konieczne do uzyskania lepszych wyników.

Przykłady poniżej pokazują, jak za pomocą curl wywołać narzędzie MCP search_places.

Żądanie 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
}'

Narzędzie: lookup_weather

Zawiera aktualne warunki pogodowe oraz prognozy godzinowe i dzienne dla dowolnej lokalizacji. Używaj tego narzędzia w przypadku wszystkich zapytań związanych z pogodą.

Dostępne dane: temperatura (aktualna, odczuwalna, maksymalna/minimalna, indeks ciepła), wiatr (prędkość, porywy, kierunek), zjawiska astronomiczne (wschód/zachód słońca, faza księżyca), opady (rodzaj, prawdopodobieństwo, ilość), warunki atmosferyczne (indeks UV, wilgotność, zachmurzenie, prawdopodobieństwo burzy) i adres lokalizacji geokodowanej.

Wymagania dotyczące danych wejściowych (KRYTYCZNE):

  • Aktualne warunki: wymaga tylko lokalizacji (np. miasta lub adresu). Nie podawaj daty ani godziny.

  • Prognozy godzinowe: wymagają podania lokalizacji i godziny (0–23). Użyj, jeśli użytkownik zapyta o pogodę o określonej godzinie lub użyje sformułowań takich jak „w ciągu najbliższych kilku godzin” lub „później”.

  • Prognozy dzienne: wymagają podania lokalizacji i pełnej daty.

Obsługa dat (KRYTYCZNA): daty i godziny podane przez użytkownika MUSZĄ być podane w lokalnej strefie czasowej żądanej lokalizacji. Daty MUSZĄ być podzielone na osobne parametry całkowite: rok, miesiąc i dzień. Wymagany format tych parametrów to: {"year": , "month": , "day": }

Przykłady poniżej pokazują, jak używać znaku curl do wywoływania narzędzia MCP lookup_weather.

Żądanie 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
}'

Narzędzie: compute_routes

Oblicza trasę podróży między określonym miejscem początkowym a docelowym. Obsługiwane środki transportu: DRIVE (domyślny), WALK.

Wymagania dotyczące danych wejściowych (KRYTYCZNE): wymaga zarówno origin, jak i destination. Każdy z nich musi być podany w jeden z tych sposobów w odpowiednim polu:

  • address: (ciąg znaków, np. „Wieża Eiffla, Paryż”). Uwaga: im bardziej szczegółowy lub konkretny jest adres wejściowy, tym lepsze będą wyniki.

  • lat_lng: (obiekt, {"latitude": liczba, "longitude": liczba})

  • place_id: (ciąg znaków, np. 'ChIJOwE_Id1w5EAR4Q27FkL6T_0') Uwaga: ten identyfikator można uzyskać za pomocą narzędzia search_places. Dozwolona jest dowolna kombinacja typów danych wejściowych (np. miejsce docelowe według adresu, miejsce docelowe według współrzędnych lat_lng). Jeśli brakuje źródła lub miejsca docelowego, musisz poprosić użytkownika o wyjaśnienie, zanim spróbujesz wywołać narzędzie.

Przykład wywołania narzędzia: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}

Poniższe przykłady pokazują, jak za pomocą curl wywołać narzędzie MCP compute_routes.

Żądanie 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
}'