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

Dies ist ein MCP-Server, der von der Maps Grounding Lite API bereitgestellt wird. Der Server bietet Tools für Entwickler, um LLM-Anwendungen auf der Google Maps Platform zu erstellen.

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 mapstools.googleapis.com 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 Verfügung stellt, um eine Aktion in der realen Welt auszuführen.

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

MCP-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 Suchanfrage sucht. Eingabeanforderungen (KRITISCH) : `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 ein (z.B. `'Google Store Mountain View opening hours'`, `'SF MoMa phone number'`, `'Shoreline Park Mountain View address'`). `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 Zentralpunkt stark zu bevorzugen `{"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}}` (ohne `radius_meters`). `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 wird, sind die Ergebnisse auf Englisch. `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 Stadt, Bundesland/Provinz und Region/Land hinzu, um die Suche einzugrenzen. Geben Sie immer die spezifischste und kontextuell reichste `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.
lookup_weather	Ruft umfassende Wetterdaten ab, einschließlich aktueller Bedingungen, stündlicher und täglicher Vorhersagen. Verfügbare spezifische Daten:Temperatur (aktuell, gefühlt, Maximum/Minimum, 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. Geografische Koordinaten (lat_lng) Verwenden Sie diese Option, wenn Sie genaue Breiten- und Längengradkoordinaten haben. Beispiel: `"lat_lng": { "latitude": 34.0522, "longitude": -118.2437 } // Los Angeles` Orts-ID (place_id) Eine eindeutige String-Kennung (Google Maps-Orts-ID). Die place_id kann mit dem Tool search_places abgerufen werden. Beispiel: `"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0" // Eiffel Tower` 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“). 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 Zeiten (z.B. „um 17:00 Uhr“) oder Begriffe wie „nächste 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 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: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.
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 in das jeweilige 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": number, "longitude": number}) 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":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}

search_places

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

Eingabeanforderungen (KRITISCH) :

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 ein (z.B. 'Google Store Mountain View opening hours', 'SF MoMa phone number', 'Shoreline Park Mountain View address').
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 Zentralpunkt stark zu bevorzugen {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (ohne radius_meters).
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 wird, sind die Ergebnisse auf Englisch.
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 Stadt, Bundesland/Provinz und Region/Land hinzu, um die Suche einzugrenzen.
Geben Sie immer die spezifischste und kontextuell reichste 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.

lookup_weather

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

Verfügbare spezifische Daten:Temperatur (aktuell, gefühlt, Maximum/Minimum, 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.

Geografische Koordinaten (lat_lng)
- Verwenden Sie diese Option, wenn Sie genaue Breiten- und Längengradkoordinaten haben.
- Beispiel: "lat_lng": { "latitude": 34.0522, "longitude": -118.2437 } // Los Angeles
Orts-ID (place_id)
- Eine eindeutige String-Kennung (Google Maps-Orts-ID).
- Die place_id kann mit dem Tool search_places abgerufen werden.
- Beispiel: "place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0" // Eiffel Tower
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“).

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 Zeiten (z.B. „um 17:00 Uhr“) oder Begriffe wie „nächste 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 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: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.

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 in das jeweilige 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": number, "longitude": number})
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":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}

MCP-Toolspezifikationen abrufen

Verwenden Sie die Methode tools/list, um die MCP-Toolspezifikationen 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 }'

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

MCP Reference: mapstools.googleapis.com Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Server einrichten

Serverendpunkte

MCP-Tools

MCP-Toolspezifikationen abrufen

MCP Reference: mapstools.googleapis.com