MCP Reference: mapstools.googleapis.com

Dies ist ein MCP-Server, der von der Maps Grounding Lite API bereitgestellt wird. Der Server bietet Tools für Entwickler, mit denen sie LLM-Anwendungen auf der Google Maps Platform erstellen können.

Ein MCP-Server (Model Context Protocol) fungiert als Proxy zwischen einem externen Dienst, der einem Large Language Model (LLM) oder einer KI-Anwendung Kontext, Daten oder Funktionen bereitstellt. MCP-Server verbinden KI-Anwendungen mit externen Systemen wie Datenbanken und Webdiensten und übersetzen deren Antworten in ein Format, das die KI-Anwendung verstehen kann.

Server einrichten

Sie müssen MCP-Server aktivieren und die Authentifizierung einrichten, bevor Sie sie verwenden können. Weitere Informationen zur Verwendung von Remote-MCP-Servern von Google und Google Cloud finden Sie unter Übersicht über Google Cloud-MCP-Server.

Serverendpunkte

Ein MCP-Dienstendpunkt ist die Netzwerkadresse und Kommunikationsschnittstelle (in der Regel eine URL) des MCP-Servers, über die eine KI-Anwendung (der Host für den MCP-Client) eine sichere, standardisierte Verbindung herstellt. Er ist der Ansprechpartner für das LLM, um Kontext anzufordern, ein Tool aufzurufen oder auf eine Ressource zuzugreifen. Google-MCP-Endpunkte können global oder regional sein.

Der MCP-Server der Maps Grounding Lite API hat den folgenden globalen MCP-Endpunkt:

  • https://mapstools.googleapis.com/mcp

MCP-Tools

Ein MCP-Tool ist eine Funktion oder ausführbare Funktion, die ein MCP-Server einem LLM oder einer KI-Anwendung zur Verfügung stellt, um eine Aktion in der realen Welt auszuführen.

Tools

Der MCP-Server mapstools.googleapis.com hat die folgenden Tools:

MCP-Tools
search_places

Rufen Sie dieses Tool auf, wenn der Nutzer nach Orten, Unternehmen, Adressen, Standorten, Points of Interest oder einer anderen Google Maps-bezogenen Suche sucht.

Eingabeanforderungen (KRITISCH) :

  1. text_query (String – ERFORDERLICH) : Die primäre Suchanfrage. Sie muss klar definieren, wonach der Nutzer sucht.

    • Beispiele: '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'.
    • Für bestimmte Ortsdetails: Fügen Sie das angeforderte Attribut hinzu (z.B. 'Google Store Mountain View opening hours', 'SF MoMa phone number', 'Shoreline Park Mountain View address').

  2. location_bias (Objekt – OPTIONAL) : Verwenden Sie diese Option, um Ergebnisse in der Nähe eines bestimmten geografischen Bereichs zu priorisieren.

    • Format:{"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
    • Verwendung:
      • Um einen Radius von 5 km zu bevorzugen {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
      • Um den Mittelpunkt stark zu bevorzugen {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (ohne radius_meters).

  3. language_code (String – OPTIONAL) : Die Sprache, in der die Zusammenfassung der Suchergebnisse angezeigt werden soll.

    • Format: Ein zweistelliger Sprachcode (ISO 639-1), optional gefolgt von einem Unterstrich und einem zweistelligen Ländercode (ISO 3166-1 alpha-2), z.B. en, ja, en_US, zh_CN, es_MX. Wenn der Sprachcode nicht angegeben ist, werden die Ergebnisse auf Englisch angezeigt.

  4. region_code (String – OPTIONAL) : Der Unicode-CLDR-Regionscode des Nutzers. Dieser Parameter wird verwendet, um die Ortsdetails wie den regionsspezifischen Ortsnamen anzuzeigen, falls verfügbar. Der Parameter kann die Ergebnisse je nach geltendem Recht beeinflussen.

    • Format:Ein zweistelliger Ländercode (ISO 3166-1 alpha-2), z.B. US, CA.

Anleitung für den Toolaufruf :

  • Standortinformationen (KRITISCH): Die Suche muss ausreichend Standortinformationen enthalten. Wenn der Standort nicht eindeutig ist (z.B. nur „Pizzerien“), müssen Sie ihn in der text_query angeben (z.B. „Pizzerien in New York“) oder den Parameter location_bias verwenden. Fügen Sie bei Bedarf den Namen der Stadt, des Bundeslands/der Provinz und der Region/des Landes hinzu, um die Suche einzugrenzen.

  • Geben Sie immer die spezifischste und kontextuell reichhaltigste text_query an.

  • Verwenden Sie location_bias nur, wenn Koordinaten explizit angegeben werden oder wenn es angemessen und notwendig ist, einen Standort aus dem bekannten Kontext eines Nutzers abzuleiten, um bessere Ergebnisse zu erzielen.

  • Die fundierte Ausgabe muss der Quelle zugeordnet werden. Verwenden Sie dazu die Informationen aus dem Feld attribution, falls verfügbar.
lookup_weather

Ruft umfassende Wetterdaten ab, einschließlich aktueller Bedingungen, stündlicher und täglicher Vorhersagen.

Verfügbare spezifische Daten:Temperatur (aktuell, gefühlte Temperatur, Höchst-/Tiefsttemperatur, Hitzeindex), Wind (Geschwindigkeit, Böen, Richtung), Himmelsereignisse (Sonnenaufgang/Sonnenuntergang, Mondphase), Niederschlag (Art, Wahrscheinlichkeit, Menge/QPF), atmosphärische Bedingungen (UV-Index, Luftfeuchtigkeit, Bewölkung, Gewitterwahrscheinlichkeit) und geocodierte Standortadresse.

Standort- und Standortregeln (KRITISCH) :

Der Standort, für den Wetterdaten angefordert werden, wird im Feld location angegeben. Dieses Feld ist eine „oneof“-Struktur. Das bedeutet, dass Sie für die genaue Suche nach Wetterdaten NUR EINEN Wert für eines der drei Unterfelder für den Standort unten angeben MÜSSEN.

  1. Geografische Koordinaten (lat_lng)

    • Verwenden Sie diese Option, wenn Sie genaue Breiten- und Längengradkoordinaten erhalten.
    • Beispiel: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // Los Angeles

  2. Orts-ID (place_id)

    • Eine eindeutige String-Kennung (Google Maps-Orts-ID).
    • Die place_id kann mit dem Tool search_places abgerufen werden.
    • Beispiel: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // Eiffelturm

  3. Adressstring (address)

    • Ein Freiform-String, der für die Geocodierung spezifisch sein muss.
    • Stadt und Region: Geben Sie immer die Region/das Land an (z.B. „London, UK“, nicht „London“).
    • Adresse: Geben Sie die vollständige Adresse an (z.B. „1600 Pennsylvania Ave NW, Washington, DC“).
    • Postleitzahlen: MÜSSEN von einem Ländernamen begleitet werden (z.B. „90210, USA“, NICHT „90210“).
    • Beispiel: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}

Verwendungsmodi :

  • Aktuelles Wetter:Geben Sie nur location an. Geben Sie date und hour nicht an.

  • Stündliche Vorhersage:Geben Sie location, date und hour (0–23) an. Verwenden Sie diese Option für bestimmte Uhrzeiten (z.B. „um 17:00 Uhr“) oder Begriffe wie „in den nächsten Stunden“ oder „später heute“. Wenn der Nutzer eine Minute angibt, runden Sie auf die nächste Stunde ab. Stündliche Vorhersagen für mehr als 120 Stunden in der Zukunft werden nicht unterstützt. Stündliche Wetterdaten aus der Vergangenheit werden bis zu 24 Stunden in der Vergangenheit unterstützt.

  • Tägliche Vorhersage:Geben Sie location und date an. Geben Sie hour nicht an. Verwenden Sie diese Option für allgemeine Tagesanfragen (z. B. „Wetter für morgen“, „Wetter am Freitag“, „Wetter am 25.12.“). Wenn das heutige Datum nicht im Kontext enthalten ist, sollten Sie es mit dem Nutzer klären. Tägliche Vorhersagen für mehr als 10 Tage einschließlich heute werden nicht unterstützt. Wetterdaten aus der Vergangenheit werden nicht unterstützt.

Parameterbeschränkungen :

  • Zeitzonen: Alle date und hour Eingaben müssen sich auf die Ortszeit des Standorts und nicht auf die Zeitzone des Nutzers beziehen.
  • Datumsformat:Die Eingaben müssen in die Ganzzahlen {year, month, day} unterteilt werden.
  • Einheiten:Die Standardeinstellung ist METRIC. Legen Sie units_system auf IMPERIAL für Fahrenheit/Meilen fest, wenn der Nutzer US-Standards impliziert oder dies explizit anfordert.

  • Die fundierte Ausgabe muss der Quelle zugeordnet werden. Verwenden Sie dazu die Informationen aus dem Feld attribution, falls verfügbar.
compute_routes

Berechnet eine Reiseroute zwischen einem angegebenen Start- und Zielort. Unterstützte Reisemodi:DRIVE (Standard), WALK.

Eingabeanforderungen (KRITISCH): Erfordert sowohl Start- als auch Zielort. Beide müssen mit einer der folgenden Methoden angegeben werden, die jeweils in das entsprechende Feld eingebettet sind:

  • address : (String, z.B. „Eiffelturm, Paris“). Hinweis: Je detaillierter oder spezifischer die eingegebene Adresse ist, desto besser sind die Ergebnisse.

  • lat_lng: : (Objekt, {"latitude": Zahl, "longitude": Zahl})

  • place_id: : (String, z.B. „ChIJOwE_Id1w5EAR4Q27FkL6T_0“) Hinweis: Diese ID kann mit dem Tool search_places abgerufen werden. Jede Kombination von Eingabetypen ist zulässig (z.B. Startort nach Adresse, Zielort nach lat_lng). Wenn der Start- oder Zielort fehlt, müssen Sie den Nutzer um eine Klärung bitten , bevor Sie versuchen, das Tool aufzurufen.

Beispiel für einen Toolaufruf : {"origin":{"address":"Eiffelturm"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}

  • Die fundierte Ausgabe muss der Quelle zugeordnet werden. Verwenden Sie dazu die Informationen aus dem Feld attribution, falls verfügbar.

MCP-Tool-Spezifikationen abrufen

Verwenden Sie die Methode tools/list, um die MCP-Tool-Spezifikationen für alle Tools auf einem MCP-Server abzurufen. Im folgenden Beispiel wird gezeigt, wie Sie mit curl alle Tools und ihre Spezifikationen auflisten, die derzeit auf dem MCP-Server verfügbar sind.

Curl-Anfrage 
                      
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
}'