MCP Tools Reference: mapstools.googleapis.com

MCP 도구 참조:

이 문서에서는 Google 원격 모델 컨텍스트 프로토콜 (MCP) 도구를 호출하는 데 사용되는 외부 REST API 엔드포인트에 대해 설명합니다. 이 API는 외부 HTTP 클라이언트 (예: curl 또는 웹 서비스)와 내부 MCP 서버 간의 보안 프록시 역할을 합니다.

MCP 도구 사양 가져오기

MCP 서버의 모든 도구에 대한 MCP 도구 사양을 가져오려면 `tools/list` 메서드를 사용하세요. 다음 예시에서는 curl를 사용하여 MCP 서버 내에서 현재 사용할 수 있는 모든 도구와 사양을 나열하는 방법을 보여줍니다.

컬 요청 
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
}'

도구: 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를 사용하세요.

다음 샘플은 curl를 사용하여 search_places MCP 도구를 호출하는 방법을 보여줍니다.

컬 요청 
curl --location 'https://mapstools.googleapis.com/mcp'
--header 'content-type: application/json'
--header 'accept: application/json, text/event-stream'
--data '{
  "method": "tools/call",
  "params": {
    "name": search_places,
    arguments: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

도구: lookup_weather

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

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

입력 요구사항 (중요):

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

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

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

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

다음 샘플은 curl를 사용하여 lookup_weather MCP 도구를 호출하는 방법을 보여줍니다.

컬 요청 
curl --location 'https://mapstools.googleapis.com/mcp'
--header 'content-type: application/json'
--header 'accept: application/json, text/event-stream'
--data '{
  "method": "tools/call",
  "params": {
    "name": lookup_weather,
    arguments: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

도구: 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"}

다음 샘플은 curl를 사용하여 compute_routes MCP 도구를 호출하는 방법을 보여줍니다.

컬 요청 
curl --location 'https://mapstools.googleapis.com/mcp'
--header 'content-type: application/json'
--header 'accept: application/json, text/event-stream'
--data '{
  "method": "tools/call",
  "params": {
    "name": compute_routes,
    arguments: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'