Google Maps MCP 서버

Google Maps API를 위한 MCP 서버.

도구

1. maps_geocode

   • 주소를 좌표로 변환

   • 입력: address (문자열)

   • 반환: 위치, 형식화된 주소, 장소 ID

2. maps_reverse_geocode

   • 좌표를 주소로 변환

   • 입력:

     • latitude (숫자)

     • longitude (숫자)

   • 반환: formatted_address, place_id, address_components

3. maps_search_places

   • 텍스트 쿼리를 사용하여 장소 검색

   • 입력:

     • query (문자열)

     • location (선택 사항): { 위도: 숫자, 경도: 숫자 }

     • radius (선택 사항): 숫자(미터, 최대 50000)

   • 반환: 이름, 주소, 위치가 포함된 장소 배열

4. maps_place_details

   • 장소에 대한 자세한 정보를 얻으세요

   • 입력: place_id (문자열)

   • 반환: 이름, 주소, 연락처 정보, 평점, 리뷰, 영업 시간

5. maps_distance_matrix

   • 지점 간 거리와 시간을 계산합니다

   • 입력:

     • origins (문자열[])

     • destinations (문자열[])

     • mode (선택 사항): "운전" | "도보" | "자전거" | "대중교통"

   • 반환: 거리 및 지속 시간 행렬

6. maps_elevation

   • 위치에 대한 고도 데이터 가져오기

   • 입력: locations (위도, 경도 배열)

   • 반환: 각 지점의 고도 데이터

7. maps_directions

   • 지점 간 길찾기

   • 입력:

     • origin (문자열)

     • destination (문자열)

     • mode (선택 사항): "운전" | "도보" | "자전거" | "대중교통"

   • 반환: 단계, 거리, 소요 시간이 포함된 경로 세부 정보

Related MCP server: mapbox-mcp-server

설정

API 키

여기의 지침에 따라 Google Maps API 키를 받으세요.

Claude Desktop과 함께 사용

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

도커

지엑스피1

엔피엑스

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

VS Code를 사용한 사용

빠른 설치를 위해 아래의 원클릭 설치 버튼 중 하나를 사용하세요...

수동 설치의 경우, VS Code의 사용자 설정(JSON) 파일에 다음 JSON 블록을 추가하세요. Ctrl + Shift + P 를 누르고 Preferences: Open User Settings (JSON) 입력하면 됩니다.

원하는 경우, 작업 공간의 .vscode/mcp.json 파일에 추가할 수 있습니다. 이렇게 하면 다른 사용자와 구성을 공유할 수 있습니다.

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

{
  "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 파일을 참조하세요.