これは、Maps Experience Agent Tools が提供する MCP サーバーです。このサーバーは、デベロッパーが Google Maps Platform 上に LLM アプリケーションを構築するためのツールを提供します。
Model Context Protocol(MCP)サーバーは、大規模言語モデル(LLM)または AI アプリケーションにコンテキスト、データ、機能を提供する外部サービスとの間のプロキシとして機能します。MCP サーバーは、AI アプリケーションをデータベースやウェブサービスなどの外部システムに接続し、そのレスポンスを AI アプリケーションが理解できる形式に変換します。
サーバーの設定
使用する前に、MCP サーバーを有効にして認証を設定する必要があります。Google と Google Cloud のリモート MCP サーバーの使用方法については、Google Cloud MCP サーバーの概要をご覧ください。
サーバー エンドポイント
MCP サービス エンドポイントは、安全で標準化された接続を確立するために AI アプリケーション(MCP クライアントのホスト)が使用する MCP サーバーのネットワーク アドレスと通信インターフェース(通常は URL)です。これは、LLM がコンテキストをリクエストしたり、ツールを呼び出したり、リソースにアクセスしたりするための接続ポイントとなります。
Maps Experience Agent Tools MCP サーバーには、次のグローバル MCP エンドポイントがあります。
- https://mapstools.googleapis.com/mcp
MCP ツール
MCP ツールは、現実世界でアクションを実行する目的で MCP サーバーが LLM または AI アプリケーションに対して公開する関数または実行可能な機能です。
ツール
mapstools.googleapis.com MCP サーバーには、次のツールがあります。
| MCP ツール | |
|---|---|
search_places |
ユーザーのリクエストが、場所、ビジネス、住所、位置、スポット、その他の Google マップ関連の検索である場合に、このツールを呼び出します。 入力要件(重要):
ツール呼び出しの手順:
|
lookup_weather |
天気、大気質(AQI と汚染物質)、花粉(木、草、雑草、植物種のアレルゲン レベル)など、ある場所の包括的な環境情報を取得します。天気と大気質については、現在の状況、1 時間ごとの予測 / 履歴、日別の予測を取得できます。花粉については、日別の予測のみを取得できます(今日から 4 日後まで。1 時間ごとのデータや過去のデータはありません)。利用可能な環境ドメインと機能(capabilities: WEATHER、AIR_QUALITY、POLLEN - 重要): * 明示的な選択が必須: すべての呼び出しで、capabilities に WEATHER、AIR_QUALITY、POLLEN のいずれかを必ず含める必要があります。capabilities を省略することはできません。* 広範 / 曖昧な屋外に関するクエリ(完全な屋外環境スイート): ユーザーが特定のドメインに限定せずに、屋外、旅行、状況に関する一般的な質問をした場合(例: 「今、ランニングをするのに屋外の状況はどうですか?」)、3 つの機能すべてを明示的に含め(capabilities: ["WEATHER", "AIR_QUALITY", "POLLEN"])、完全な屋外環境スイート(天気 + 大気質 + 花粉)を返します。過去の date / hour の場合は、履歴がない POLLEN を除外します。* 対象ドメインの選択(特定のクエリ): ユーザーが 1 つまたは 2 つのドメインのみを具体的にリクエストした場合(例: 「シアトルの現在の AQI はリアルタイムでどうなっていますか?」)、リクエストされた機能(WEATHER、AIR_QUALITY、POLLEN)のみを含めます。リクエストされたドメインのみが実行され、返されます。ドメインごとに利用可能な特定のデータ: * 天気(weather): 気温(現在、体感、最高 / 最低、熱指数)、風(風速、突風、風向)、天体イベント(日の出 / 日の入り、月相)、降水量(種類、確率、量 / QPF)、大気条件(UV 指数、湿度、雲量、雷雨確率、気圧)。* 大気質(air_quality): 世界および地域の大気質指数(AQI 値、カテゴリ、主要な汚染物質)、7 つの感受性グループにわたる健康に関する推奨事項、汚染物質濃度(include_pollutant_concentration: true)。各指数には独自の主要な汚染物質があります。指数ごとに報告してください(例: 米国の AQI に世界の AQI の汚染物質を指定しないでください)。* 花粉(pollen): 樹木、草、雑草のカテゴリ別、植物種別の 1 日のユニバーサル花粉指数(UPI、0 ~ 5)(index.value とその index.category、例: 1 = 「非常に低い」)、シーズン中のステータス、交差反応、健康に関する推奨事項。* 花粉フィールドがない: in_season がない場合は、季節外れであることを意味します。index なしで返された植物種は、ユーザーがその植物について尋ねた場合を除き、省略します。その場合は、その植物の花粉データは今日報告されていないことを伝えます(レベルを推測しないでください)。場所のルール(重要): 対象地域は、次の oneof サブフィールドのいずれか 1 つのみを使用して location で指定する必要があります。1. 地理座標(lat_lng): * 正確な緯度 / 経度座標がわかっている場合に使用します。* 例: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} 2. プレイス ID(place_id): * 明確な Google マップのプレイス ID(search_places または resolve_names から取得したものなど)。* 例: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} 3. 住所文字列(address): * 市区町村 / 地域、近隣地域、ランドマーク、スポット、番地、郵便番号。市区町村 / 国も指定することをおすすめします。* 例: {"location": {"address": "Paris, France"}} 時間と使用モード(date と hour - 重要): * 現地タイムゾーンの参照: すべての date({year, month, day})と hour(0-23)の入力は、リクエストされた location の現地常用タイムゾーン(例: "Paris tomorrow at 13:00" のクエリでは Europe/Paris の現地の日付と時間 13 を使用)で表す必要があります。UTC や呼び出し元のタイムゾーンは使用しないでください。* 1. 現在の状況(date と hour を省略): * location とターゲット capabilities(WEATHER、AIR_QUALITY、POLLEN)を指定します。date または hour は指定しないでください。* リクエストされたドメインのリアルタイムの現在の状況(CC)(現在の天気、現在の時間の大気質、今日の花粉予報)を返します。* 大気質の場合、現在の状況は 1 時間単位です。今日全体の大気質や屋外に関する一般的な質問に回答する場合は、これだけを使用しないでください(以下の日次クエリを使用してください)。* 2. 1 時間ごとの天気予報 / 履歴(date と hour を指定 0-23): * location、date({year, month, day})、hour(0-23)、ターゲット capabilities を指定します。分単位で記載されている場合は、最も近い時間に切り捨てます。* 重要な制約(hour が設定されている場合、date は必須): date を指定せずに hour を指定する(date を省略し、hour を設定する)ことは許可されていません。エラーが発生します。ユーザーが今日の特定の時間(例: "at 13:00 today")について尋ねている場合でも、date(今日の location)と hour の両方を入力する必要があります。* YYYY-MM-DD-HH でリクエストされた天気や大気質を 1 時間ごとに検索し、YYYY-MM-DD でリクエストされた花粉を 1 日ごとに検索します。* 天気に関する「いつ」の質問: いつ / 何時 / 最適な時間を尋ねる天気に関する質問(例: "what time will it stop raining?")の場合、該当する時間帯について 1 時間ごとの WEATHER 呼び出し(date + hour)を使用します。1 日の天気予報には 1 時間ごとの値はありません。屋外での活動全般に関する「いつ / 最適な時間」の質問(例: "when is the best time to go walking today?")については、1 日のクエリで説明されている大気質(および花粉)の 1 日全体の呼び出しに加えて、1 時間ごとの WEATHER 呼び出しを行います。* 3. 1 日のクエリ(date を指定し、hour を省略): * location、date(リクエストされた location の現地時間での {year, month, day})を hour なしで指定し、1 日のクエリのターゲット capabilities(例: "weather and pollen in London tomorrow")を指定します。 * 今日の大気質と屋外に関する一般的な質問: 大気質に関する質問と、今日に関する屋外に関する一般的な質問(大気質を含む)(例: "how will the air quality change today"、"is today a good day for a picnic?")の場合、date を今日の location の日付(時間は省略)に設定して、その日の 1 時間ごとの大気質シリーズを取得します。現在の状況の呼び出しだけでは、現在の時間の大気質しか返されないため、十分ではありません。ユーザーが「現在」についても尋ねている場合は、追加できます。* 大気質の時間枠: 1 日の時間枠("air quality between noon and 6 PM" など)に関する大気質の質問については、個々の時間をサンプリングするのではなく、その日付の 1 回の Daily 呼び出しを優先し、大気質シリーズから時間枠の時間を読み取ります。1 時間ごとに電話をかける場合は、時間枠のすべての時間帯をカバーします。* リクエストされた天気や花粉の日次予測と、その日の 1 時間ごとの大気質シリーズを、現地時間の 1 日全体(現地時間の 00:00 ~ 23:00)にわたって返します。過去の日付の場合は 24 時間の履歴、将来の日付の場合は 24 時間の予測、今日の場合はそれ以前の時間(履歴)、現在の時間、残りの時間(予測)を返します。ドメイン別のサポート対象期間: * 天気: 24 時間前から 240 時間(10 日)先までの 1 時間単位(過去の時間には date と hour の両方が必要)。今日を含む 10 日先(今日から 9 日後まで)までの 1 日単位。1 日単位の履歴はなし。* Air Quality: 720 時間(30 日)前から 96 時間(4 日)後までの 1 時間単位。1 日全体の呼び出しは、この期間内に収まる必要があります(実際には、今日から 29 日前から 3 日後まで)。* 花粉: 1 日単位のみ、今日から 4 日後まで(今日を含めて 5 日間)。過去の日付は含まれず、hour は無視されます。* (注: 複数の機能がリクエストされ、date/hour がそのいずれかの範囲外にある場合でも、呼び出しは成功し、サポートされている機能のみが返されます。)* 範囲外のリクエスト: リクエストされた日付または時間が上記のドメインのサポート範囲外である可能性がある場合(過去の日付の花粉など)でも、リクエストされた日付 / 時間に対して lookup_weather を呼び出します。エラーにはサポート範囲が示されます。代わりに別の日付、時間、ドメインを呼び出さないでください。ドメイン オプションとアトリビューション: * 言語(language_code): 省略可能な BCP-47 言語コード(例: "fr")。デフォルトは "en" です。* 天気情報の単位(weather_options.units_system または units_system): デフォルトは METRIC です。お客様が米国標準を暗示している場合、またはインペリアル単位を明示的にリクエストしている場合は、IMPERIAL(華氏 / mph)に設定します。weather_options.units_system(推奨)と最上位の units_system の両方でサポートされています。両方を指定する場合は、競合しないようにする必要があります。* 大気質オプション(air_quality_options): 特定の汚染物質濃度(PM2.5、PM10、O3、NO2、SO2、CO)が必要な場合は include_pollutant_concentration: true を設定します。必要に応じて、index_region_code(2 文字の ISO 国コード、例: "US")を設定して、特定の地域の AQI スケールをリクエストします。デフォルトでは、レスポンスにはユニバーサル AQI とその場所の地域 AQI が含まれます。* 帰属表示: グラウンディングされた出力は、返された各ドメイン コンテナ(weather.attribution、air_quality.attribution、pollen.attribution)内の attribution フィールドを使用して、ソースに帰属させる必要があります。* 返される時刻: Air Quality の date_time 値は、すでにその場所の現地時間(utc_offset を含む)になっているため、そのまま表示します。天気 date_time(現在と 1 時間ごと)と日の出 / 日の入りの時刻は UTC です。time_zone を使用して、その場所の現地時間に変換します。すべての時刻を現地時間としてラベル付けします。
|
compute_routes |
出発地と目的地の間の移動ルートを計算します。必要に応じて、中間地点を経由することもできます。各ルートの距離と所要時間を返します。 入力要件(重要):
ツール呼び出しの手順:
ツール呼び出しの例: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"intermediate_waypoints":[{"address":"Louvre Museum"}],"travel_mode":"DRIVE","departure_time":"2026-09-19T08:00:00+02:00"} 回答の手順:
|
search_along_route |
ユーザーが旅行ルート沿いの場所、店舗、スポットを検索したい場合(例: 「タホに向かう途中のガソリンスタンド」、「サンフランシスコとサンノゼの間のカフェ」)に、このツールを呼び出します。このツールを呼び出すと、 入力要件(重要):
ツール呼び出しの手順:
|
resolve_names |
特定の場所のクエリ(ランドマーク名や正確な住所)のバッチリストを、正規の Google マップ プレイス ID に解決します。 入力要件(重要):
ツール呼び出しの手順:
Google マップに保存する:
エラー処理(重大):
|
resolve_maps_urls |
Google マップの URL のリストを正規の Google マップ プレイス ID に解決します。 このツールを呼び出すタイミング(重要):
入力要件(重要):
Google マップに保存する:
エラー処理(重大):
|
MCP ツールの仕様を取得する
MCP サーバー内のすべてのツールの MCP ツール仕様を取得するには、tools/list メソッドを使用します。次の例は、curl を使用して、MCP サーバー内で現在使用可能なすべてのツールとその仕様を一覧表示する方法を示しています。
| 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 }' |