MCP Reference: mapstools.googleapis.com

Serwer protokołu kontekstu modelu (MCP) działa jako serwer proxy między usługą zewnętrzną, która udostępnia kontekst, dane lub funkcje dużemu modelowi językowemu (LLM) lub aplikacji AI. Serwery MCP łączą aplikacje AI z systemami zewnętrznymi, takimi jak bazy danych i usługi internetowe, tłumacząc ich odpowiedzi na format zrozumiały dla aplikacji AI.

Jest to serwer MCP udostępniany przez interfejs Maps Grounding Lite API. Serwer udostępnia deweloperom narzędzia do tworzenia aplikacji LLM na platformie Google Maps Platform.

Punkty końcowe serwera

Punkt końcowy usługi MCP to adres sieciowy i interfejs komunikacyjny (zwykle adres URL) serwera MCP, którego aplikacja AI (host klienta MCP) używa do nawiązywania bezpiecznego, standardowego połączenia. Jest to punkt kontaktowy, za pomocą którego LLM może prosić o kontekst, wywoływać narzędzie lub uzyskiwać dostęp do zasobu. Punkty końcowe Google MCP mogą być globalne lub regionalne.

Serwer MCP mapstools.googleapis.com ma ten punkt końcowy MCP:

Narzędzia MCP

Narzędzie MCP to funkcja lub możliwość wykonywania, którą serwer MCP udostępnia modelowi LLM lub aplikacji AI w celu wykonania działania w rzeczywistym świecie.

Serwer MCP mapstools.googleapis.com zawiera te narzędzia:

Narzędzia MCP
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.
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": }
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"}