Questa pagina è stata tradotta dall'API Cloud Translation.

Toolkit di Google Maps Platform Code Assist

Descrizione

Il toolkit Google Maps Platform Code Assist è un server Model Context Protocol (MCP) che migliora le risposte dei modelli linguistici di grandi dimensioni (LLM) utilizzati per sviluppare applicazioni con Google Maps Platform basando le risposte sulla documentazione e sugli esempi di codice ufficiali e aggiornati.

Poiché il server MCP accede ai contenuti quando viene richiesto il modello, il contesto del LLM relativo a Google Maps Platform non deve essere limitato ai dati disponibili alla data di addestramento del modello.

Le risorse Google Maps Platform a cui il server MCP può accedere includono:

Documentazione della piattaforma di Google Maps
Termini di servizio di Google Maps Platform
Centro affidabilità di Google Maps Platform
Repository di codice nelle organizzazioni GitHub ufficiali di Google Maps Platform

Strumenti forniti

Il server MCP espone i seguenti strumenti per i client AI:

retrieve-instructions: uno strumento di assistenza utilizzato dal cliente per ottenere istruzioni di sistema cruciali su come ragionare al meglio sull'intento dell'utente e formulare chiamate efficaci allo strumento retrieve-google-maps-platform-docs.
retrieve-google-maps-platform-docs: lo strumento principale. Prende una query in linguaggio naturale e la invia a un motore RAG (Retrieval-Augmented Generation) ospitato. Il motore RAG esegue ricerche nelle versioni aggiornate della documentazione ufficiale, dei tutorial e degli esempi di codice della piattaforma Google Maps, restituendo il contesto pertinente all'AI per generare una risposta accurata.

Trasporti MCP supportati

Questo server supporta due protocolli di comunicazione MCP standard:

stdio: questo è il trasporto predefinito utilizzato quando un client richiama il server tramite un command. Comunica tramite i flussi di input/output standard, il che lo rende ideale per l'esecuzione locale da riga di comando.
Streamable HTTP: il server espone un endpoint /mcp che accetta richieste POST. Viene utilizzato dai client che si connettono tramite un url ed è lo standard per le connessioni ai server remoti. La nostra implementazione supporta lo streaming per risposte interattive in tempo reale.

Utilizzo

Puoi eseguire il server MCP di Code Assist sulla tua macchina di sviluppo locale o in remoto su Google Cloud Run.

Requisiti

Per utilizzare il toolkit Google Maps Platform Code Assist, devi disporre di un ambiente con Node.js (è consigliata la versione LTS) e npm installato per clonare ed eseguire il server, nonché di un client MCP per accedere al server.

Utilizzare Code Assist come server MCP locale con trasporto `stdio` (consigliato)

Esegui il server sulla tua macchina locale e connetti i client utilizzando il protocollo stdio per l'utilizzo con IDE assistiti dall'AI (come VS Code, Android Studio, Cursor) o applicazioni AI desktop (come Gemini CLI). Questa è la configurazione più semplice e comune.

Configura il client

Aggiungi il server al file di configurazione MCP del client AI che preferisci. Trova il tuo client di seguito per istruzioni specifiche e verificate.

Gemini Code Assist e Gemini CLI
- Opzione 1: aggiungi il server direttamente dalla riga di comando (presupponendo che tu abbia già installato Gemini CLI):
```
 gemini mcp add google-maps-platform-code-assist npx -y @googlemaps/code-assist-mcp@latest
```
  - Verifica l'installazione eseguendo gemini mcp list.
- Opzione 2: installa Code Assist come estensione dell'interfaccia a riga di comando di Gemini con preambolo statico, lo strumento MCP e il tema di base di Google Maps:
```
gemini extensions install https://github.com/googlemaps/platform-ai.git
```
- Opzione 3: aggiungi manualmente la configurazione del server MCP al file ~/.gemini/settings.json.
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}
```
Claude Code
- Opzione 1: aggiungi il server direttamente dalla riga di comando (presupponendo che tu abbia già installato Claude Code):
```
    claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist-mcp@latest
```
  - Verifica l'installazione eseguendo claude mcp list.
  - Utenti Windows:su Windows nativo (non WSL), devi utilizzare il wrapper cmd /c per i comandi npx per farli funzionare correttamente.
```
claude mcp add google-maps-platform-code-assist -- cmd /c "npx -y @googlemaps/code-assist-mcp@latest"
```
- Opzione 2: aggiungi manualmente il server al file di configurazione di Claude ~/.claude.json
```
"mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": [
        "-y", "@googlemaps/code-assist-mcp@latest"
      ]
    }
  }
```
Cursore
- <-- If you already have Cursor installed, click here to install Google Maps Platform Code Assist MCP directly.
- In caso contrario, aggiungila al file .cursor-settings/mcp.json dello spazio di lavoro.
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}
```

Firebase Studio

con Code Assist MCP installato
Aggiungi al file mcp.json del progetto nella cartella .idx del workspace Firebase Studio

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

Android Studio

Crea un file mcp.json e inseriscilo nella directory di configurazione di Android Studio. Aggiungi il server Code Assist all'elenco:

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

Cline
- Opzione 1: esegui l'installazione utilizzando la GUI Cline MCP
- Opzione 2: esegui l'installazione manualmente / a livello di programmazione utilizzando il file di configurazione MCP di Cline. Il file di configurazione si trova in:
  - 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
  - Aggiungi quanto segue alla configurazione MCP in 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"
      ]
    }
  }
}
```
Codice Canguro
- Opzione 1: installa utilizzando la GUI Roo MCP
- Opzione 2: esegui l'installazione manualmente / a livello di programmazione utilizzando il file di configurazione Roo Code. Il file di configurazione si trova in:
  - 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
  - Aggiungi quanto segue alla configurazione MCP in 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
- In modalità Agente, fai clic su "Strumenti", poi su "Configura strumenti" nell'intestazione in alto e infine su "Installa da un nome di pacchetto NPM" (vedi gli screenshot di seguito).
- Inserisci il nome del pacchetto @googlemaps/code-assist-mcp e premi INVIO, accettando l'installazione e utilizzando la porta predefinita 3000, quindi premi INVIO un'ultima volta per confermare la modifica.
Windsurf
- Simile alle istruzioni per il cursore riportate sopra.
Kilo Code
- Simile alle istruzioni per il codice Cline e Roo riportate sopra