Esta página foi traduzida pela API Cloud Translation.

Kit de ferramentas do Google Maps Platform Code Assist

Descrição

O kit de ferramentas do Code Assist da Plataforma Google Maps é um servidor de protocolo de contexto de modelo (MCP) que melhora as respostas de modelos de linguagem grandes (LLMs) usados para desenvolver aplicativos com a Plataforma Google Maps, baseando as respostas na documentação e nos exemplos de código oficiais e atualizados.

Como o servidor do MCP acessa o conteúdo quando o modelo é solicitado, o contexto do LLM em relação à Plataforma Google Maps não precisa ser limitado aos dados disponíveis na data de treinamento do modelo.

Os recursos da Plataforma Google Maps que o servidor MCP pode acessar incluem:

Documentação da Plataforma Google Maps
Termos de Serviço da Plataforma Google Maps
Central de confiança da Plataforma Google Maps
Repositórios de código nas organizações oficiais do GitHub da Plataforma Google Maps

Desenvolvedores

🪄 Transforme seu assistente de IA ou IDE favorito em um especialista da Plataforma Google Maps. Com o Code Assist, os agentes de IA, como a CLI do Gemini, o Claude Code e o Cursor, podem gerar código e responder a perguntas de desenvolvedores com base na documentação e nos exemplos de código oficiais e atualizados da Plataforma Google Maps, diretamente no seu fluxo de trabalho de desenvolvimento.
🚀 Seja para fazer mudanças precisas no código com a ajuda da IA ou para criar um novo protótipo de app, o Code Assist pode ajudar você a concluir a tarefa com mais rapidez e facilidade.

🔧 Ferramentas fornecidas

O servidor MCP expõe as seguintes ferramentas para clientes de IA:

retrieve-instructions: uma ferramenta auxiliar usada pelo cliente para receber instruções cruciais do sistema sobre como entender melhor a intenção do usuário e formular chamadas eficazes para a ferramenta retrieve-google-maps-platform-docs.
retrieve-google-maps-platform-docs: a ferramenta principal. Ele recebe uma consulta em linguagem natural e a envia para um mecanismo hospedado de geração aumentada de recuperação (RAG, na sigla em inglês). O mecanismo de RAG pesquisa versões atualizadas da documentação oficial, tutoriais e exemplos de código da Plataforma Google Maps, retornando o contexto relevante para a IA gerar uma resposta precisa.

🛠️ Transports do MCP compatíveis

Esse servidor é compatível com dois protocolos de comunicação MCP padrão:

stdio: é o transporte padrão usado quando um cliente invoca o servidor por um command. Ele se comunica pelos fluxos de entrada/saída padrão, o que o torna ideal para execução local na linha de comando.
Streamable HTTP: o servidor expõe um endpoint /mcp que aceita solicitações POST. Usado por clientes que se conectam por um url e é o padrão para conexões de servidor remoto. Nossa implementação oferece suporte a streaming para respostas interativas em tempo real.

🚀 Uso

É possível executar o servidor MCP do Code Assist na sua máquina de desenvolvimento local ou remotamente no Google Cloud Run.

Requisitos

Para usar o kit de ferramentas do Code Assist da Plataforma Google Maps, você precisa de um ambiente com Node.js (versão LTS recomendada) e npm instalado para clonar e executar o servidor, além de um cliente MCP para acessar o servidor.

Usar o Code Assist como um servidor MCP local com transporte `stdio` (recomendado)

Execute o servidor na sua máquina local e conecte clientes usando o protocolo stdio para uso com IDEs assistidos por IA (como VS Code, Android Studio, Cursor) ou aplicativos de IA para computador (como a CLI do Gemini). Essa é a configuração mais simples e comum.

Configurar o cliente

Adicione o servidor ao arquivo de configuração do MCP do cliente de IA preferido. Encontre seu cliente abaixo para conferir instruções específicas e verificadas.

Gemini Code Assist e CLI do Gemini
- Opção 1: adicione o servidor diretamente da linha de comando (supondo que você já tenha a CLI do Gemini instalada):
```
 gemini mcp add google-maps-platform-code-assist npx -y @googlemaps/code-assist-mcp@latest
```
  - Verifique a instalação executando gemini mcp list.
- Opção 2: instale o Code Assist como uma extensão da CLI do Gemini com pré-âmbulo estático, a ferramenta MCP e o tema básico do Google Maps:
```
gemini extensions install https://github.com/googlemaps/platform-ai.git
```
- Opção 3: adicione manualmente a configuração do servidor MCP ao arquivo ~/.gemini/settings.json.
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}
```
Claude Code
- Opção 1: adicione o servidor diretamente da linha de comando (supondo que você já tenha o Claude Code instalado):
```
    claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist-mcp@latest
```
  - Verifique a instalação executando claude mcp list.
  - Usuários do Windows:no Windows nativo (não WSL), use o wrapper cmd /c para que os comandos npx funcionem corretamente.
```
claude mcp add google-maps-platform-code-assist -- cmd /c "npx -y @googlemaps/code-assist-mcp@latest"
```
- Opção 2: adicionar o servidor manualmente ao arquivo de configuração do Claude ~/.claude.json
```
"mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": [
        "-y", "@googlemaps/code-assist-mcp@latest"
      ]
    }
  }
```
Cursor
- <-- Se você já tiver o Cursor instalado, clique aqui para instalar o MCP do Code Assist da Plataforma Google Maps diretamente.
- Caso contrário, adicione ao arquivo .cursor-settings/mcp.json do espaço de trabalho.
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}
```

Firebase Studio

com o MCP do Code Assist instalado
Adicione ao arquivo mcp.json do projeto na pasta .idx do espaço de trabalho do Firebase Studio.

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

Android Studio

Crie um arquivo mcp.json e coloque-o no diretório de configuração do Android Studio. Adicione o servidor do Code Assist à lista:

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

Cline
- Opção 1: instalar usando a GUI do Cline MCP
- Opção 2: instale manualmente / por programação usando o arquivo de configuração do MCP do Cline. O arquivo de configuração está localizado em:
  - 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
  - Adicione o seguinte à configuração do MCP em cline_mcp_settings.json:
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"],
      "alwaysAllow": [
        "retrieve-instructions",
        "retrieve-google-maps-platform-docs"
      ]
    }
  }
}
```
Código Roo
- Opção 1: instalar usando a GUI do Roo MCP
- Opção 2: instalar manualmente / programaticamente usando o arquivo de configuração do Roo Code. O arquivo de configuração está localizado em:
  - 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
  - Adicione o seguinte à configuração do MCP em mcp_settings.json:
```
{
  "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
- No modo agente, clique em "Ferramentas" e, no cabeçalho superior, em "Configurar ferramentas" e "Instalar de um nome de pacote NPM". Consulte as capturas de tela abaixo.
- Digite o nome do pacote @googlemaps/code-assist-mcp e ENTER, aceitando a instalação e usando a porta padrão 3000. Depois, pressione ENTER mais uma vez para confirmar a mudança.
Windsurf
- Semelhante às instruções de cursor acima.
Kilo Code (em inglês)
- Semelhante às instruções de código de Cline e Roo acima

Saiba mais

Para mais informações sobre como instalar e usar o kit de ferramentas, além dos termos de uso, consulte o README do repositório do GitHub.

Kit de ferramentas do Google Maps Platform Code Assist Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.