[][npm-pkg]

AI를 위한 Google Maps Platform 리소스

설명

[!WARNING] Google Maps Platform Code Assist의 npm 버전은 더 이상 사용되지 않습니다. 2026년 7월 1일부터 더 이상 제공되지 않습니다. 이 README에 문서화된 안전하게 호스팅되는 원격 MCP 버전을 기본 연결 방법으로 사용하세요.

이 저장소에는 Google Maps Platform을 사용하여 애플리케이션을 개발할 때 대규모 언어 모델(LLM)의 응답을 공식적이고 최신의 문서와 코드 샘플에 근거하여 향상시키는 Model Context Protocol(MCP) 서버인 Google Maps Platform Code Assist 툴킷이 포함되어 있습니다.

Related MCP server: google-maps-mcp-server

🔧 사용 가능한 MCP 도구 (gmp-code-assist)

다음 필수 도구가 포함된 gmp-code-assist MCP 서버에 액세스할 수 있습니다:

• retrieve-google-maps-platform-docs: RAG를 통해 Google Maps Platform 문서, 코드 샘플, 아키텍처 센터 및 GitHub 저장소를 검색합니다.

  • 매개변수: llmQuery(필수 문자열 쿼리), filter(선택적 API/제품 영역 필터), source(선택적 문자열 호출자 식별자, 최대 64자).

• retrieve-instructions: Google Maps Platform 모범 사례에 대한 기본 컨텍스트를 검색합니다.

  • 매개변수: name(필수 문자열, 예상 형식은 단순히 "instructions").

Gemini CLI용 Google Maps Platform Code Assist 확장 프로그램 설치

1. Gemini CLI 설치 (대체 설치 방법)

npm install -g @google/gemini-cli

2. Google Maps Platform 확장 프로그램 설치

   • 옵션 1 - Code Assist를 Gemini CLI 확장 프로그램으로 설치 (컨텍스트 프롬프트, Code Assist MCP 도구 및 Google Maps Platform CLI 테마 포함):

     gemini extensions install https://github.com/googlemaps/platform-ai.git

     • gemini mcp list를 실행하여 설치를 확인합니다.

   • 옵션 2 - Google에서 호스팅하는 원격 서비스에 안전하게 연결하려면 ~/.gemini/settings.json 파일에 MCP 서버 구성을 수동으로 추가합니다:

     {
       "mcpServers": {
        "gmp-code-assist": {
          "httpUrl": "https://mapscodeassist.googleapis.com/mcp"
        }
       }
     }

Google Maps Platform 에이전트 스킬

AI 에이전트에 특화된 휴대용 Google Maps Platform 워크플로와 모범 사례를 갖추려면 공식 Google Maps Platform Agent Skills 저장소를 확인하세요.

Gemini CLI에 에이전트 스킬 설치:

gemini skills install https://github.com/googlemaps/agent-skills.git

다른 MCP 클라이언트용 Google Maps Platform Code Assist 툴킷 설치

모든 MCP 클라이언트에서 툴킷을 설치하고 사용하는 방법과 이용 약관에 대한 자세한 내용은 Code Assist 툴킷 README를 참조하세요.

샘플 프롬프트

Code Assist MCP 서버 또는 지원되는 AI 에이전트를 시작하려면 다음 예제 프롬프트를 사용하세요:

• Routes API를 사용하고 React + TypeScript의 지도에 표시하는 방법을 보여주세요.

• 지도를 2D에서 3D 사실적(Photorealistic)으로 업그레이드하려고 합니다. 어떤 옵션이 있고 기존 코드베이스로 어떻게 할 수 있나요?

• Places API(신규) Text Search API 구현을 Places UI Kit로 변경하세요. 이 변경으로 사용자당 절감되는 비용을 추정해 주세요.

• Address Validation과 Geocoding의 차이점을 설명해 주세요. 전자상거래 결제 사용 사례의 현재 코드베이스에 어떤 것을 적용해야 하며 그 이유는 무엇인가요?

• API 키가 필요합니다. 키를 생성하여 내 앱 환경 변수에 추가해 주시겠어요?