MCP Reference: mapstools.googleapis.com

Ein Model Context Protocol (MCP)-Server 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 versteht.

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 Google Cloud-MCP-Server – Übersicht.

Dies ist ein MCP-Server, der von der Maps Grounding Lite API bereitgestellt wird. Der Server bietet Entwicklern Tools zum Erstellen von LLM-Anwendungen auf der Google Maps Platform.

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. Es 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 für die Maps Grounding Lite API hat den folgenden 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 Ausführung einer Aktion in der realen Welt zur Verfügung stellt.

Der MCP-Server „mapstools.googleapis.com“ enthält die folgenden Tools:

MCP-Tools
search_places

Rufen Sie dieses Tool auf, wenn der Nutzer nach Orten, Unternehmen, Adressen, Standorten, Sehenswürdigkeiten oder anderen Google Maps-bezogenen Suchanfragen sucht.

Anforderungen an die Eingabe (WICHTIG):

  1. text_query (String – ERFORDERLICH): Die primäre Suchanfrage. Darin muss klar definiert werden, 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): Damit können Sie Ergebnisse in der Nähe eines bestimmten geografischen Gebiets 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}}}
      • Starke Gewichtung des Mittelpunkts: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (radius_meters wird ausgelassen).

  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. Mit diesem Parameter werden die Ortsdetails angezeigt, z. B. der regionsspezifische Ortsname, sofern verfügbar. Der Parameter kann sich je nach anwendbarem Recht auf die Ergebnisse auswirken.

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

Instructions for Tool Call:

  • Standortinformationen (KRITISCH): Die Suche muss ausreichend Standortinformationen enthalten. Wenn der Standort nicht eindeutig ist (z.B. nur „Pizzerien“), müssen Sie ihn im text_query angeben (z.B. „Pizzerien in New York“) oder den Parameter location_bias verwenden. Geben Sie bei Bedarf den Namen der Stadt, des Bundesstaats/der Provinz und der Region/des Landes an, um Mehrdeutigkeiten zu vermeiden.

  • Geben Sie immer die spezifischste und kontextbezogenste text_query an, die möglich ist.

  • Verwenden Sie location_bias nur, wenn Koordinaten explizit angegeben werden oder wenn das Ableiten eines Standorts aus dem bekannten Kontext eines Nutzers angemessen und für bessere Ergebnisse erforderlich ist.

  • Die fundierte Ausgabe muss der Quelle zugeordnet werden. Verwenden Sie dazu die Informationen aus dem Feld attribution, sofern 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, Hitzewelle), Wind (Geschwindigkeit, Böen, Richtung), Himmelsereignisse (Sonnenaufgang/-untergang, Mondphase), Niederschlag (Art, Wahrscheinlichkeit, Menge/QPF), atmosphärische Bedingungen (UV-Index, Luftfeuchtigkeit, Wolkendecke, Wahrscheinlichkeit von Gewittern) und geocodierte Standortadresse.

Standort und Standortregeln (WICHTIG):

Der Ort, für den Wetterdaten angefordert werden, wird mit dem Feld location angegeben. Dieses Feld ist eine „oneof“-Struktur. Das bedeutet, dass Sie NUR für EINES der drei Unterfelder für den Standort unten einen Wert angeben MÜSSEN, damit die Wetterdaten korrekt abgerufen werden.

  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 frei definierbarer String, der für die Geocodierung spezifisch sein muss.
    • Stadt und Region: Geben Sie immer die Region/das Land an, z.B. „London, UK“ (London, Vereinigtes Königreich) statt „London“.
    • Adresse: Geben Sie die vollständige Adresse an, z.B. „1600 Pennsylvania Ave NW, Washington, DC“.
    • Postleitzahlen: MÜSSEN mit einem Ländernamen angegeben werden (z.B. „90210, USA“, NICHT „90210“).
    • Beispiel: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}

Verwendungsmodi:

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

  • Stündliche Vorhersage:Geben Sie location, date und hour (0–23) an. Verwenden Sie 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, runde auf die nächste volle Stunde ab. Stündliche Vorhersagen, die mehr als 120 Stunden in der Zukunft liegen, werden nicht unterstützt. Stündliche Wetterdaten aus der Vergangenheit werden bis zu 24 Stunden zurück unterstützt.

  • Tagesvorhersage:Gib location und date an. Geben Sie nicht hour an. 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. Tagesprognosen für mehr als 10 Tage ab heute werden nicht unterstützt. Verlaufsdaten zum Wetter werden nicht unterstützt.

Parameterbeschränkungen:

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

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

Berechnet eine Route zwischen einem angegebenen Start- und Zielort. Unterstützte Mobilitätsformen:DRIVE (Standard), WALK.

Anforderungen an die Eingabe (WICHTIG): Sowohl origin als auch destination sind erforderlich. Jeder Wert muss mit einer der folgenden Methoden im jeweiligen Feld angegeben werden:

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

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

  • place_id: (String, z.B. „ChIJOwE_Id1w5EAR4Q27FkL6T_0“): Hinweis: Diese ID kann mit dem Tool „search_places“ abgerufen werden. Beliebige Kombinationen von Eingabetypen sind zulässig, z.B. Startpunkt nach Adresse und Zielpunkt nach lat_lng. Wenn der Start- oder Zielort fehlt, MÜSSEN Sie den Nutzer um Klärung bitten, bevor Sie versuchen, das Tool aufzurufen.

Beispiel für Tool-Aufruf: {"origin":{"address":"Eiffel Tower"},"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, sofern verfügbar.

Spezifikationen für MCP-Tools abrufen

Wenn Sie die MCP-Tool-Spezifikationen für alle Tools auf einem MCP-Server abrufen möchten, verwenden Sie die Methode tools/list. 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
}'