Google Maps

Google Maps MCP 서버는 Google Maps API를 위한 MCP 서버입니다.

특징

주소와 좌표 간 변환(지오코딩 및 역지오코딩)
텍스트 쿼리를 사용한 장소 검색
장소에 대한 상세 정보 조회
지점 간 거리 및 시간 계산
위치별 고도 데이터 조회
지점 간 경로 안내

API

도구

maps_geocode

주소를 좌표로 변환합니다.

입력:
address (문자열)
반환: location, formatted_address, place_id

maps_reverse_geocode

좌표를 주소로 변환합니다.

입력:
latitude (숫자)
longitude (숫자)
반환: formatted_address, place_id, address_components

maps_search_places

텍스트 쿼리를 사용하여 장소를 검색합니다.

입력:
query (문자열)
location (선택적): { latitude: 숫자, longitude: 숫자 }
radius (선택적): 숫자(미터, 최대 50000)
반환: 이름, 주소, 위치가 포함된 장소 배열

maps_place_details

장소에 대한 상세 정보를 조회합니다.

입력:
place_id (문자열)
반환: 이름, 주소, 연락처 정보, 평점, 리뷰, 영업 시간

maps_distance_matrix

지점 간 거리 및 시간을 계산합니다.

입력:
origins (문자열[])
destinations (문자열[])
mode (선택적): "driving" | "walking" | "bicycling" | "transit"
반환: 거리 및 소요 시간 매트릭스

maps_elevation

위치별 고도 데이터를 조회합니다.

입력:
locations (배열 {latitude, longitude})
반환: 각 지점에 대한 고도 데이터

maps_directions

지점 간 경로를 안내합니다.

입력:
origin (문자열)
destination (문자열)
mode (선택적): "driving" | "walking" | "bicycling" | "transit"
반환: 단계, 거리, 소요 시간이 포함된 경로 세부 정보

사용 방법

API 키 설정

여기의 지침에 따라 Google Maps API 키를 가져옵니다.

Claude Desktop에서 사용

claude_desktop_config.json에 다음을 추가하세요:

Docker

{
  "mcpServers": {
    "google-maps": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "GOOGLE_MAPS_API_KEY", "mcp/google-maps"],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "google-maps": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-google-maps"],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

VS Code에서 사용

VS Code User Settings(JSON) 파일에 다음 JSON 블록을 추가하세요. Ctrl + Shift + P를 누르고 Preferences: Open User Settings (JSON)를 입력하여 이 작업을 수행할 수 있습니다.

선택적으로 작업 공간의 .vscode/mcp.json 파일에 추가할 수 있습니다. 이렇게 하면 다른 사람과 구성을 공유할 수 있습니다.

.vscode/mcp.json 파일에서는 mcp 키가 필요하지 않습니다.

NPX

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "maps_api_key",
        "description": "Google Maps API Key",
        "password": true
      }
    ],
    "servers": {
      "google-maps": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-google-maps"],
        "env": {
          "GOOGLE_MAPS_API_KEY": "${input:maps_api_key}"
        }
      }
    }
  }
}

Docker 설치

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "maps_api_key",
        "description": "Google Maps API Key",
        "password": true
      }
    ],
    "servers": {
      "google-maps": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "mcp/google-maps"],
        "env": {
          "GOOGLE_MAPS_API_KEY": "${input:maps_api_key}"
        }
      }
    }
  }
}

빌드

Docker 빌드:

docker build -t mcp/google-maps -f src/google-maps/Dockerfile .

라이선스

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 이는 MIT 라이선스의 약관 및 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있음을 의미합니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.

MCP 문서 앱 설치

iOS에 앱 설치하기

메뉴

문서 정보

Google Maps MCP 서버