이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Google Maps Platform 코드 어시스트 툴킷

설명

Google Maps Platform Code Assist 툴킷은 공식 최신 문서와 코드 샘플을 기반으로 대답을 그라운딩하여 Google Maps Platform으로 애플리케이션을 개발하는 데 사용되는 대규모 언어 모델 (LLM)의 대답을 개선하는 모델 컨텍스트 프로토콜 (MCP) 서버입니다.

모델이 프롬프트될 때 MCP 서버가 콘텐츠에 액세스하므로 Google Maps Platform에 관한 LLM의 컨텍스트가 모델의 학습 날짜에 제공된 데이터로 제한되지 않습니다.

MCP 서버가 액세스할 수 있는 Google Maps Platform 리소스는 다음과 같습니다.

Google Maps Platform 문서
Google Maps Platform 서비스 약관
Google Maps Platform 신뢰 센터
Google Maps Platform 공식 GitHub 조직의 코드 저장소

🔧 제공되는 도구

MCP 서버는 AI 클라이언트에 다음 도구를 노출합니다.

retrieve-instructions: 클라이언트가 사용자 의도를 가장 잘 추론하고 retrieve-google-maps-platform-docs 도구에 대한 효과적인 호출을 공식화하는 방법에 관한 중요한 시스템 지침을 가져오는 데 사용하는 도우미 도구입니다.
retrieve-google-maps-platform-docs: 기본 도구입니다. 자연어 쿼리를 가져와 호스팅된 검색 증강 생성 (RAG) 엔진에 제출합니다. RAG 엔진은 최신 버전의 공식 Google Maps Platform 문서, 튜토리얼, 코드 샘플을 검색하여 정확한 대답을 생성할 수 있도록 AI에 관련 컨텍스트를 반환합니다.

🛠️ 지원되는 MCP 전송

이 서버는 다음과 같은 두 가지 표준 MCP 통신 프로토콜을 지원합니다.

stdio: 클라이언트가 command를 통해 서버를 호출할 때 사용되는 기본 전송입니다. 표준 입력/출력 스트림을 통해 통신하므로 로컬 명령줄 실행에 적합합니다.
Streamable HTTP: 서버는 POST 요청을 수락하는 /mcp 엔드포인트를 노출합니다. 이는 url를 통해 연결하는 클라이언트에서 사용되며 원격 서버 연결의 표준입니다. Google 구현은 실시간 대화형 응답을 위한 스트리밍을 지원합니다.

🚀 사용

로컬 개발 머신에서 또는 Google Cloud Run에서 원격으로 Code Assist MCP 서버를 실행할 수 있습니다.

요구사항

Google Maps Platform 코드 어시스트 툴킷을 사용하려면 서버를 클론하고 실행하기 위해 Node.js (LTS 버전 권장) 및 npm이 설치된 환경과 서버에 액세스할 MCP 클라이언트가 필요합니다.

`stdio` 전송과 함께 코드 어시스트를 로컬 MCP 서버로 사용 (권장)

로컬 머신에서 서버를 실행하고 stdio 프로토콜을 사용하여 클라이언트를 연결하여 AI 지원 IDE (예: VS Code, Android Studio, Cursor) 또는 데스크톱 AI 애플리케이션 (예: Gemini CLI)과 함께 사용합니다. 가장 간단하고 일반적인 설정입니다.

클라이언트 구성

선호하는 AI 클라이언트의 MCP 구성 파일에 서버를 추가합니다. 아래에서 클라이언트를 찾아 인증된 구체적인 안내를 확인하세요.

Gemini Code Assist 및 Gemini CLI
- 옵션 1 - 명령줄에서 직접 서버 추가 (Gemini CLI가 이미 설치되어 있다고 가정):
```
 gemini mcp add google-maps-platform-code-assist npx -y @googlemaps/code-assist-mcp@latest
```
  - gemini mcp list을 실행하여 설치를 확인합니다.
- 옵션 2 - 정적 프리앰블, MCP 도구, 기본 Google 지도 테마를 사용하여 Code Assist를 Gemini CLI 확장 프로그램으로 설치합니다.
```
gemini extensions install https://github.com/googlemaps/platform-ai.git
```
- 옵션 3 - ~/.gemini/settings.json 파일에 MCP 서버 구성을 수동으로 추가합니다.
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}
```
Claude Code
- 옵션 1 - 명령줄에서 직접 서버 추가 (Claude Code가 이미 설치되어 있다고 가정):
```
    claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist-mcp@latest
```
  - claude mcp list을 실행하여 설치를 확인합니다.
  - Windows 사용자: 네이티브 Windows (WSL 아님)에서는 npx 명령어가 올바르게 작동하도록 cmd /c 래퍼를 사용해야 합니다.
```
claude mcp add google-maps-platform-code-assist -- cmd /c "npx -y @googlemaps/code-assist-mcp@latest"
```
- 옵션 2 - Claude 구성 파일 ~/.claude.json에 서버를 수동으로 추가
```
"mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": [
        "-y", "@googlemaps/code-assist-mcp@latest"
      ]
    }
  }
```
커서
- <-- 이미 Cursor가 설치되어 있는 경우 여기를 클릭하여 Google Maps Platform Code Assist MCP를 직접 설치하세요.
- 그렇지 않으면 작업 공간의 .cursor-settings/mcp.json 파일에 추가합니다.
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}
```

Firebase Studio

Code Assist MCP가 설치된
Firebase Studio 작업공간의 .idx 폴더에 있는 프로젝트의 mcp.json 파일에 추가

{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}

Android 스튜디오
- mcp.json 파일을 만들고 Android 스튜디오의 구성 디렉터리에 배치합니다. 목록에 Code Assist 서버를 추가합니다.
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}
```
Cline
- 옵션 1: Cline MCP GUI를 사용하여 설치
- 옵션 2: Cline MCP 구성 파일을 사용하여 수동 / 프로그래매틱 방식으로 설치합니다. 구성 파일은 다음 위치에 있습니다.
  - macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  - Windows: %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  - Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  - cline_mcp_settings.json의 MCP 구성에 다음을 추가합니다.
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"],
      "alwaysAllow": [
        "retrieve-instructions",
        "retrieve-google-maps-platform-docs"
      ]
    }
  }
}
```
Roo 코드
- 옵션 1: Roo MCP GUI를 사용하여 설치
- 옵션 2: Roo 코드 구성 파일을 사용하여 수동 / 프로그래매틱 방식으로 설치합니다. 구성 파일은 다음 위치에 있습니다.
  - macOS: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
  - Windows: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\mcp_settings.json
  - Linux: ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
  - mcp_settings.json의 MCP 구성에 다음을 추가합니다.
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"],
      "alwaysAllow": [
        "retrieve-instructions",
        "retrieve-google-maps-platform-docs"
      ]            
    }
  }
}
```
Microsoft Copilot
- 에이전트 모드에서 '도구'를 클릭한 다음 상단 헤더에서 '도구 구성', 'NPM 패키지 이름에서 설치'를 클릭합니다(아래 스크린샷 참고).
- 패키지 이름 @googlemaps/code-assist-mcp을 입력하고 Enter 키를 눌러 설치를 수락하고 기본 포트 3000을 사용한 다음 마지막으로 Enter 키를 눌러 변경사항을 확인합니다.
Windsurf
- 위의 커서 안내와 유사합니다.
Kilo Code
- 위의 Cline 및 Roo 코드 안내와 유사합니다.