지도 환경 에이전트 도구에서 제공하는 MCP 서버입니다. 이 서버는 개발자가 Google Maps Platform을 기반으로 LLM 애플리케이션을 빌드할 수 있는 도구를 제공합니다.
모델 컨텍스트 프로토콜(MCP) 서버는 대규모 언어 모델(LLM) 또는 AI 애플리케이션에 컨텍스트, 데이터 또는 기능을 제공하는 외부 서비스 간의 프록시 역할을 합니다. MCP 서버는 AI 애플리케이션을 데이터베이스 및 웹 서비스와 같은 외부 시스템에 연결하여 응답을 AI 애플리케이션이 이해할 수 있는 형식으로 변환합니다.
서버 설정
사용하기 전에 MCP 서버를 사용 설정하고 인증을 설정해야 합니다. Google 및 Google Cloud 원격 MCP 서버 사용에 대한 자세한 내용은 Google Cloud MCP 서버 개요를 참조하세요.
서버 엔드포인트
MCP 서비스 엔드포인트는 AI 애플리케이션(MCP 클라이언트의 호스트)이 안전하고 표준화된 연결을 설정하는 데 사용하는 MCP 서버의 네트워크 주소 및 통신 인터페이스(일반적으로 URL)입니다. LLM이 컨텍스트를 요청하거나, 도구를 호출하거나, 리소스에 액세스하는 연락 지점입니다.
지도 환경 에이전트 도구 MCP 서버에는 다음과 같은 전역 MCP 엔드포인트가 있습니다.
- https://mapstools.googleapis.com/mcp
MCP 도구
MCP 도구는 MCP 서버가 LLM 또는 AI 애플리케이션에 노출하여 실제 세계에서 작업을 수행하는 함수 또는 실행 가능한 기능입니다.
도구
mapstools.googleapis.com MCP 서버에는 다음과 같은 도구가 있습니다.
| MCP 도구 | |
|---|---|
search_places |
사용자가 장소, 비즈니스, 주소, 위치, 관심 장소 또는 기타 Google 지도 관련 검색을 요청할 때 이 도구를 호출합니다. 입력 요구사항(중요):
도구 호출 안내:
|
lookup_weather |
특정 위치의 종합적인 환경 인텔리전스를 가져옵니다. 여기에는 날씨, 공기질(AQI 및 오염 물질), 꽃가루(나무, 잔디, 잡초, 식물 종 알레르기 유발 물질 수준)가 포함됩니다. 날씨 및 공기질의 경우 현재 상태, 시간별 예보/이력, 일일 예보가 제공되며, 꽃가루의 경우 일일 예보만 제공됩니다(오늘부터 +4일까지, 시간별 또는 과거 데이터 없음). 사용 가능한 환경 도메인 및 기능(capabilities: WEATHER, AIR_QUALITY, POLLEN — 중요): * 필수 명시적 선택: 모든 호출에서 capabilities에 WEATHER, AIR_QUALITY 또는 POLLEN 중 하나 이상을 반드시 포함해야 합니다. capabilities를 생략하는 것은 허용되지 않습니다. * 광범위하거나 모호한 야외 관련 질문(전체 야외 환경 도구): 사용자가 특정 도메인으로 제한하지 않고 일반적인 야외, 여행 또는 상황에 관한 질문을 하는 경우(예: "지금 조깅하기에 야외 환경이 어때?") 세 가지 기능을 모두 명시적으로 포함(capabilities: ["WEATHER", "AIR_QUALITY", "POLLEN"])하여 전체 야외 환경 도구(날씨 + 공기질 + 꽃가루)를 반환합니다. 과거 date/hour의 경우 기록이 없는 POLLEN는 제외합니다. * 타겟팅된 도메인 선택(특정 질문): 사용자가 하나 또는 두 개의 도메인만 구체적으로 요청하는 경우(예: "지금 시애틀의 AQI는 얼마인가요?") 요청된 기능(WEATHER, AIR_QUALITY, POLLEN)만 포함합니다. 요청된 도메인만 실행되고 반환됩니다. 도메인별로 제공되는 특정 데이터: * 날씨(weather): 기온(현재, 체감, 최고/최저, 열 지수), 바람(풍속, 돌풍, 풍향), 천체 현상(일출/일몰, 달의 위상), 강수량(유형, 확률, 양/QPF), 대기 상태(자외선 지수, 습도, 구름량, 뇌우 확률, 기압) * 공기질(air_quality): 범용 및 지역 공기질 지수(AQI 값, 카테고리, 주요 오염 물질), 7개 민감도 그룹에 대한 건강 권장사항, 오염 물질 농도(include_pollutant_concentration: true). 각 지수에는 고유한 주요 오염 물질이 있습니다. 지수별로 보고하세요(예: 미국 AQI에 범용 AQI의 오염 물질을 제공하지 않음). * 꽃가루(pollen): 나무, 잔디, 잡초 카테고리 및 식물 종별 일일 범용 꽃가루 지수(UPI, 0~5)(index.value 및 index.category, 예: 1 = '매우 낮음'), 계절 상태, 교차 반응, 건강 권장사항. * 꽃가루 필드 누락: in_season가 누락되면 해당 꽃가루가 발생하는 계절이 아님을 의미합니다. 사용자가 해당 식물에 대해 묻지 않는 한 index 없이 반환된 식물 종은 제외합니다. 그런 다음 오늘은 꽃가루 데이터가 보고되지 않는다고 말합니다(수치를 추론하지 않음). 위치 규칙(중요): 타겟 위치는 다음 oneof 하위 필드 중 하나만 사용하여 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. 시간별 예측/기록(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에서 요청된 날씨 또는 공기질을 매시간 조회하고 YYYY-MM-DD에서 요청된 꽃가루를 매일 조회합니다. * 날씨 '언제' 질문: 언제 / 몇 시 / 가장 좋은 시간을 묻는 날씨 질문(예: "what time will it stop raining?")의 경우 관련 시간에 시간별 WEATHER 호출(date + hour)을 사용합니다. 일일 일기예보에는 시간별 값이 없습니다. 광범위한 야외 '언제/가장 좋은 시간' 질문(예: "when is the best time to go walking today?")의 경우 일일 질문에 설명된 공기질(및 꽃가루)에 대한 하루 종일 호출 외에도 시간별 WEATHER 호출을 수행합니다. * 3. 일일 쿼리(date 지정 및 hour 생략): * hour 없이 location, date(요청된 location의 현지 민간 시간으로 {year, month, day}) 및 하루 종일 쿼리의 대상 capabilities(예: "weather and pollen in London tomorrow")를 제공합니다. * 오늘의 공기질 및 광범위한 야외 질문: 오늘의 공기질 질문 및 광범위한 야외 질문(공기질 포함)(예: "how will the air quality change today", "is today a good day for a picnic?")의 경우 date를 오늘 날짜의 location(시간 생략)로 설정하여 해당 날짜의 시간별 공기질 시리즈를 가져옵니다. 현재 상태 호출만으로는 현재 시간의 공기질만 반환되므로 충분하지 않습니다. 사용자가 '현재'에 대해서도 질문하는 경우 추가할 수 있습니다. * 공기질 시간대: 하루 내 시간대에 관한 공기질 질문(예: "air quality between noon and 6 PM")의 경우 개별 시간을 샘플링하는 대신 해당 날짜의 일일 호출을 선호하고 공기질 시리즈에서 시간대의 시간을 읽습니다. 시간별 통화를 사용하는 경우 해당 시간대의 모든 시간을 포함합니다. * 요청된 날씨 또는 꽃가루의 일일 예보와 하루 전체(현지 시간 00:00~23:00)를 포괄하는 당일의 시간별 공기질 시리즈를 반환합니다. 과거 날짜의 경우 과거 24시간, 미래 날짜의 경우 예측 24시간, 오늘의 경우 이전 시간(과거), 현재 시간, 남은 시간(예측)을 반환합니다. 도메인별 지원 기간: * 날씨: 24시간 전부터 최대 240시간(10일) 후까지 시간별(과거 시간은 date 및 hour 모두 필요), 오늘을 포함하여 최대 10일(오늘부터 +9일)까지 일별, 일별 기록 없음. * 공기질: 720시간(30일) 전부터 96시간(4일) 후까지 시간별로 제공됩니다. 하루 전체 호출은 이 기간 내에 있어야 합니다(실제로는 오늘 -29일부터 +3일까지). * 꽃가루: 일일만, 오늘부터 +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 필드를 사용하여 소스에 대한 출처를 표시해야 합니다(MUST). * 반환된 시간: Air Quality date_time 값은 이미 위치의 현지 시간(utc_offset 포함)으로 되어 있으므로 그대로 표시합니다. 날씨 date_time(현재 및 시간별) 및 일출/일몰 시간은 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 }' |