Toolkit di Google Maps Platform Code Assist

Descrizione

Il toolkit Code Assist per Google Maps Platform è un server Model Context Protocol (MCP) che migliora le risposte dei modelli linguistici di grandi dimensioni (LLM) utilizzati per lo sviluppo di 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 dell'LLM relativo a Google Maps Platform non deve essere limitato ai dati disponibili alla data di addestramento del modello.

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

• Documentazione di Google Maps Platform
• 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:

1. retrieve-instructions: uno strumento di assistenza utilizzato dal client 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.
2. retrieve-google-maps-platform-docs: lo strumento principale. Accetta una query in linguaggio naturale e la invia a un motore Retrieval Augmented Generation (RAG) ospitato. Il motore RAG cerca le versioni più recenti della documentazione, dei tutorial e degli esempi di codice ufficiali di Google Maps Platform, 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 da riga di comando locale.
• Streamable HTTP: il server espone un endpoint /mcp che accetta le richieste POST. Viene utilizzato dai client che si connettono tramite un url ed è lo standard per le connessioni server remote. La nostra implementazione supporta lo streaming per risposte interattive in tempo reale.

Utilizzo

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

Requisiti

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

Utilizza Code Assist come server MCP locale con trasporto stdio (opzione consigliata)

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.

1. Gemini Code Assist & Gemini CLI

   • Opzione 1: aggiungi il server direttamente dalla riga di comando (supponendo 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 il server MCP Code Assist come estensione di Gemini CLI:

     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"]
       }
     }
   }
   

2. Claude Code

   • Opzione 1: aggiungi il server direttamente dalla riga di comando (supponendo 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"
         ]
       }
     }
   

3. Cursor

   • <-- Se hai già installato Cursor, fai clic qui per installare direttamente il server MCP Code Assist per Google Maps Platform.
   • In caso contrario, aggiungilo al file .cursor-settings/mcp.json del tuo workspace.

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

4. Firebase Studio

   • con il server MCP Code Assist installato
   • Aggiungi il file mcp.json del tuo progetto nella cartella .idx del tuo workspace Firebase Studio

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

5. 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"]
       }
     }
   }
   

6. Cline

   • Opzione 1: installa utilizzando la GUI MCP di Cline
   • Opzione 2: installa manualmente / programmaticamente 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"
             ]
           }
         }
       }
       

7. Roo Code

   • Opzione 1: installa utilizzando la GUI MCP di Roo
   • Opzione 2: installa manualmente / programmaticamente utilizzando il file di configurazione di 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"
             ]            
           }
         }
       }
       

8. Microsoft Copilot

   • In modalità Agente, fai clic su "Strumenti", poi nell'intestazione in alto su "Configura strumenti" 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, accetta l'installazione e utilizza la porta predefinita 3000, poi premi Invio un'ultima volta per confermare la modifica

   • 

9. Windsurf

   • Simile alle istruzioni di Cursor riportate sopra.

10. Kilo Code

    • Simile alle istruzioni di Cline e Roo Code riportate sopra

Scopri di più

Per ulteriori informazioni sull'installazione e sull'utilizzo del toolkit, nonché sui termini di utilizzo, consulta il file README del repository GitHub README.