Kit de ferramentas do Google Maps Platform Code Assist

Descrição

O kit de ferramentas do Code Assist da Plataforma Google Maps é um servidor do Protocolo de Contexto de Modelo (MCP, na sigla em inglês) que melhora as respostas de modelos de linguagem grandes (LLMs) usados para desenvolver aplicativos com a Plataforma Google Maps, fundamentando as respostas na documentação e nos exemplos de código oficiais e atualizados.

Como o servidor 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

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 importantes do sistema sobre como raciocinar melhor sobre 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. Ela recebe uma consulta em linguagem natural e a envia para um mecanismo de geração aumentada de recuperação (RAG, na sigla em inglês) hospedado. O mecanismo de RAG pesquisa versões recentes 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.

Transportes de MCP com suporte

Esse servidor oferece suporte a dois protocolos de comunicação MCP padrão:

stdio: esse é 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 de linha de comando.
Streamable HTTP: o servidor expõe um endpoint /mcp que aceita solicitações POST. Ele é 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

Você pode 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 o npm instalados 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 seu cliente

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

Gemini Code Assist e CLI do Gemini
- Opção 1: adicione o servidor diretamente na 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
```
  - Confirme a instalação executando gemini mcp list.
- Opção 2: instale o servidor MCP do Code Assist como uma extensão da CLI do Gemini:
```
gemini extensions install https://github.com/googlemaps/platform-ai.git
```
- Opção 3: adicione a configuração do servidor MCP manualmente 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 na 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
```
  - Confirme a instalação executando claude mcp list.
  - Usuários do Windows:no Windows nativo (não WSL), é necessário usar 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: adicione 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-o ao arquivo .cursor-settings/mcp.json do seu 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 seu projeto na pasta .idx no 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: instale usando a GUI do Cline MCP
- Opção 2: instale manualmente / programaticamente usando o arquivo de configuração do Cline MCP. 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"
      ]
    }
  }
}
```
Roo Code
- Opção 1: instale usando a GUI do Roo MCP
- Opção 2: instale 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)
- Insira o nome do pacote @googlemaps/code-assist-mcp e pressione ENTER, aceitando a instalação e usando a porta padrão 3000. Em seguida, pressione ENTER mais uma vez para confirmar a mudança.
Windsurf
- Semelhante às instruções do Cursor acima.
Kilo Code
- Semelhante às instruções do Cline e do Roo Code acima

Saiba mais

Para mais informações sobre como instalar e usar o kit de ferramentas, bem como os Termos de Serviço, consulte o README do repositório do GitHub README.

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.