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

Sviluppatori

• 🪄 Trasforma il tuo assistente AI o IDE preferito in un esperto di Google Maps Platform. Con Code Assist, gli agenti AI come Gemini CLI, Claude Code e Cursor possono generare codice e rispondere alle domande degli sviluppatori basandosi su documentazione e campioni di codice ufficiali e aggiornati di Google Maps Platform, direttamente nel tuo flusso di lavoro di sviluppo.

• 🚀 Che tu stia apportando modifiche al codice con precisione assistita dall'AI o creando un prototipo di nuova app, Code Assist può aiutarti a portare a termine l'attività più rapidamente e facilmente.

🔧 Strumenti forniti

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

1. retrieve-instructions: uno strumento di assistenza utilizzato dal cliente per ottenere istruzioni di sistema cruciali su come ragionare al meglio sull'intent dell'utente e formulare chiamate efficaci allo strumento retrieve-google-maps-platform-docs.
2. 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 il 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.

1. Gemini Code Assist e interfaccia a riga di comando di Gemini

   • 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: 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@latest
     

     • Verifica l'installazione eseguendo claude mcp list.
     • Utenti Windows:su Windows nativo (non WSL), devi utilizzare il wrapper cmd /c per far funzionare correttamente i comandi npx.

     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-mc@latest"
         ]
       }
     }
   

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

4. Firebase Studio

   • con MCP Code Assist 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"]
       }
     }
   }
   

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: esegui l'installazione utilizzando la GUI Cline MCP
   • Opzione 2: esegui l'installazione 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. Codice Canguro

   • Opzione 1: installa utilizzando la GUI Roo MCP
   • Opzione 2: esegui l'installazione manualmente / programmaticamente utilizzando il file di configurazione del codice Roo. 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 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.

   • 

9. Windsurf

   • Simile alle istruzioni per il cursore riportate sopra.

10. Kilo Code

    • Simile alle istruzioni per il codice Cline e Roo riportate sopra

Scopri di più

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