MCP Reference: mapstools.googleapis.com

모델 컨텍스트 프로토콜 (MCP) 서버는 대규모 언어 모델 (LLM) 또는 AI 애플리케이션에 컨텍스트, 데이터 또는 기능을 제공하는 외부 서비스 간의 프록시 역할을 합니다. MCP 서버는 AI 애플리케이션을 데이터베이스 및 웹 서비스와 같은 외부 시스템에 연결하여 AI 애플리케이션이 이해할 수 있는 형식으로 응답을 변환합니다.

이는 Maps Grounding Lite API에서 제공하는 MCP 서버입니다. 서버는 개발자가 Google Maps Platform을 기반으로 LLM 애플리케이션을 빌드할 수 있는 도구를 제공합니다.

서버 엔드포인트

MCP 서비스 엔드포인트는 AI 애플리케이션 (MCP 클라이언트의 호스트)이 보안 표준 연결을 설정하는 데 사용하는 MCP 서버의 네트워크 주소 및 통신 인터페이스 (일반적으로 URL)입니다. LLM이 컨텍스트를 요청하거나, 도구를 호출하거나, 리소스에 액세스할 때 사용하는 연락처입니다. Google MCP 엔드포인트는 전역 또는 리전일 수 있습니다.

mapstools.googleapis.com MCP 서버에는 다음과 같은 MCP 엔드포인트가 있습니다.

MCP 도구

MCP 도구는 MCP 서버가 실제 환경에서 작업을 실행하기 위해 LLM 또는 AI 애플리케이션에 노출하는 함수 또는 실행 가능한 기능입니다.

mapstools.googleapis.com MCP 서버에는 다음과 같은 도구가 있습니다.

MCP 도구
search_places

사용자의 요청이 장소, 비즈니스, 주소, 위치, 관심분야 또는 기타 Google 지도 관련 검색을 찾는 것인 경우 이 도구를 호출합니다.

입력 요구사항 (중요):

  1. text_query (문자열 - 필수): 기본 검색 쿼리입니다. 사용자가 무엇을 찾고 있는지 명확하게 정의해야 합니다.

    • 예: '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'
    • 특정 장소 세부정보: 요청된 속성 (예: 'Google Store Mountain View opening hours', 'SF MoMa phone number', 'Shoreline Park Mountain View address')를 사용하려고 할 때 Tegra2 기반 기기 및 기타 기기가 비정상 종료되었습니다.

  2. location_bias (객체 - 선택사항): 특정 지리적 영역 근처의 결과를 우선순위로 지정하는 데 사용합니다.

    • 형식: {"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
    • 사용:
      • 5km 반경으로 편향하려면 다음을 사용하세요. {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
      • 중심점을 향해 강한 편향을 적용하려면 {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (radius_meters 생략)을 사용합니다.

  3. language_code (문자열 - 선택사항): 검색 결과 요약을 표시할 언어입니다.

    • 형식: 두 글자로 된 언어 코드 (ISO 639-1)와 원하는 경우 밑줄 및 두 글자로 된 국가 코드 (ISO 3166-1 alpha-2)가 뒤에 올 수 있습니다. en, ja, en_US, zh_CN, es_MX 언어 코드가 제공되지 않으면 결과가 영어로 표시됩니다.

  4. region_code (문자열 - 선택사항): 사용자의 유니코드 CLDR 지역 코드입니다. 이 매개변수는 사용 가능한 경우 지역별 장소 이름과 같은 장소 세부정보를 표시하는 데 사용됩니다. 이 매개변수는 관련 법률에 따라 결과에 영향을 줄 수 있습니다.

    • 형식: 두 글자로 된 국가 코드(ISO 3166-1 alpha-2)(예: US, CA.

도구 호출 안내:

  • 위치 정보 (심각): 검색에 충분한 위치 정보가 포함되어야 합니다. 위치가 모호한 경우 (예: '피자 가게'만) text_query에서 지정해야 합니다 (예: '뉴욕의 피자 가게')을 사용하거나 location_bias 매개변수를 사용합니다. 명확성을 위해 필요한 경우 도시, 주/도, 지역/국가 이름을 포함합니다.

  • 항상 최대한 구체적이고 맥락이 풍부한 text_query을 제공하세요.

  • 좌표가 명시적으로 제공되거나 사용자의 알려진 컨텍스트에서 위치를 추론하는 것이 더 나은 결과를 위해 적절하고 필요한 경우에만 location_bias를 사용하세요.
lookup_weather

모든 위치의 현재 상황, 시간별 예보, 일일 예보를 제공합니다. 날씨와 관련된 모든 문의에는 이 도구를 사용하세요.

사용 가능한 특정 데이터: 온도 (현재, 체감, 최대/최소, 열 지수), 바람 (풍속, 돌풍, 방향), 천체 현상 (일출/일몰, 달의 위상), 강수 (유형, 확률, 양/QPF), 대기 조건 (자외선 지수, 습도, 운량, 뇌우 확률), 지오코딩된 위치 주소

입력 요구사항 (중요):

  • 현재 조건: 위치 (예: 도시 또는 주소)만 필요합니다. 날짜나 시간을 지정하지 마세요.

  • 시간별 예보: 위치와 시간 (0~23)이 필요합니다. 사용자가 특정 시간의 날씨를 묻거나 '다음 몇 시간' 또는 '오늘 오후'과 같은 용어를 사용하는 경우 사용합니다.

  • 일일 예보: 위치와 전체 날짜가 필요합니다.

날짜 처리(심각): 사용자 제공 날짜와 시간은 요청된 위치의 현지 시간대로 제공되어야 합니다(MUST). 날짜는 연도, 월, 일의 별도 정수 매개변수로 구분해야 합니다(MUST). 이러한 매개변수의 필수 형식은 {"year": , "month": , "day": }입니다.
compute_routes

지정된 출발지와 목적지 간의 이동 경로를 계산합니다. 지원되는 이동 수단: DRIVE (기본값), WALK

입력 요구사항 (중요): 출발지와 도착지가 모두 필요합니다. 각각은 다음 방법 중 하나를 사용하여 해당 필드 내에 중첩되어 제공되어야 합니다.

  • address: (문자열, 예: '에펠탑, 파리'). 참고: 입력 주소가 더 세부적이거나 구체적일수록 결과가 더 좋습니다.

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

  • place_id: (문자열, 예: 'ChIJOwE_Id1w5EAR4Q27FkL6T_0') 참고: 이 ID는 search_places 도구에서 가져올 수 있습니다. 입력 유형의 조합은 허용됩니다 (예: 주소별 출발지, lat_lng별 도착지). 출발지나 목적지가 누락된 경우 도구를 호출하기 전에 사용자에게 명확한 정보를 요청해야 합니다(MUST).

도구 호출 예: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}