먼저 maps_geocode 로 주소를 좌표로 바꾼다

누구에게 맞나

이미 Google Maps API 키가 있고 MCP 대화에서 주소를 좌표로 바꾸고 싶다면 이 서버가 맞다. 공식 설명은 Google Maps API 의 MCP Server 라는 것이다.

아직 키가 없는 환경에는 맞지 않다. 발췌는 Google 문서에 따라 키를 만들라고 하며, 문서 주소는 https://developers.google.com/maps/documentation/javascript/get-api-key#create-api-keys . 설정 변수 이름은 GOOGLE_MAPS_API_KEY 이며 자신의 키를 넣어야 하고, 예시 자리 표시 값을 복사하지 말 것.

현재 발췌에서 입출력이 완전히 적힌 도구는 maps_geocode 뿐이다: 입력 address (string), 반환 location, formatted_address, place_id. 다른 능력은 이 발췌에 나오지 않으므로 도구 이름을 스스로 채우지 말 것. 이것은 지오코딩 읽기이며 여전히 Google Maps API 를 호출한다. 네트워크 없음이나 프라이버시 경계 없음으로 이해하지 말 것.

3 분 안에 첫 시도 마치기

먼저 위 문서에서 자신의 키를 받는다. 공식이 권하는 주 경로는 MCP 설정에서 npx 로 시작하는 것이다. 병렬로 Docker 를 또 쓰지 말 것:

"command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-google-maps"],

같은 설정의 환경 변수에서 GOOGLE_MAPS_API_KEY 를 실제 키로 설정한다. 이 조각을 지금 쓰는 MCP 클라이언트 설정 위치에 넣는다. 발췌는 파일 이름을 고정하지 않았다. 저장하고 다시 로드한다.

첫 번째는 maps_geocode 만 호출하고, 이미 가진 주소 문자열을 넣는다. 나오지 않은 매개변수 이름을 지어내지 말 것. 성공 신호는 location, formatted_address, place_id 가 돌아오는 것이며, GOOGLE_MAPS_API_KEY 가 없거나 npx 가 @modelcontextprotocol/server-google-maps 를 못 띄운다는 안내가 아니다.

사용 사례

사례 1: 주소를 좌표로 바꾼다. 발췌는 maps_geocode 가 Convert address to coordinates 에 쓰이며, 입력은 address 문자열, 반환에 location 이 포함된다고 적는다. 자신의 주소를 제출해야 한다. 확인할 수 있는 것은 location 필드다. 좌표 형식의 더 많은 세부사항은 발췌에 쓰이지 않았다.

사례 2: 같은 지오코딩으로 표준 주소와 장소 식별자를 받는다. 발췌는 반환에 formatted_address 와 place_id 도 포함된다고 적는다. 성공 시에는 정규화된 주소와 place_id 가 보여야 하며 좌표 묶음만은 아니어야 한다. 그 필드로 다음에 무엇을 할 수 있는지는 현재 발췌에 다음 도구가 없으므로, 나오지 않은 상세 조회를 입증된 것처럼 쓰지 말 것.

두 사례 모두 maps_geocode 위에 있으며, coordinates 와 formatted_address/place_id 를 각각 취할 뿐이다. 현재 발췌에는 두 번째로 지명된 도구가 없다.

사용 경계

주 경로는 npx -y @modelcontextprotocol/server-google-maps 이며 GOOGLE_MAPS_API_KEY 를 설정한다. 발췌에는 docker run 이미지 mcp/google-maps 도 나오며 같은 환경 변수가 필요하다. 그것은 경쟁 설치 경로이므로 첫 시도에서 병렬로 쓰지 말 것.

공식 페이지는 https://github.com/modelcontextprotocol/servers-archived/tree/main/src/google-maps . 키 생성 설명은 https://developers.google.com/maps/documentation/javascript/get-api-key#create-api-keys . 예시 자리 표시 키를 설정에 쓰지 말 것. 나오지 않은 도구 이름, 경로 계획, 할당량 숫자는 스스로 보완하지 말 것.