Kit de herramientas de Code Assist de Google Maps Platform

Description

El kit de herramientas de Code Assist de Google Maps Platform es un servidor de Protocolo de contexto del modelo (MCP) que mejora las respuestas de los modelos de lenguaje grandes (LLM) que se usan para desarrollar aplicaciones con Google Maps Platform, ya que fundamenta las respuestas en la documentación y las muestras de código oficiales y actualizadas.

Dado que el servidor de MCP accede al contenido cuando se le solicita al modelo, el contexto del LLM en relación con Google Maps Platform no tiene que limitarse a los datos disponibles en la fecha de entrenamiento del modelo.

Entre los recursos de Google Maps Platform a los que puede acceder el servidor de MCP, se incluyen los siguientes:

• Documentación de Google Maps Platform
• Condiciones del Servicio de Google Maps Platform
• Centro de confianza de Google Maps Platform
• Repositorios de código en las organizaciones oficiales de GitHub de Google Maps Platform

Herramientas proporcionadas

El servidor de MCP expone las siguientes herramientas para los clientes de IA:

1. retrieve-instructions: Es una herramienta auxiliar que usa el cliente para obtener instrucciones cruciales del sistema sobre cómo razonar mejor la intención del usuario y formular llamadas eficaces a la herramienta de retrieve-google-maps-platform-docs.
2. retrieve-google-maps-platform-docs: Es la herramienta principal. Toma una búsqueda en lenguaje natural y la envía a un motor de generación aumentada por recuperación (RAG) alojado. El motor RAG busca versiones recientes de la documentación oficial de la plataforma de Google Maps, tutoriales y ejemplos de código, devolviendo el contexto relevante a la IA para generar una respuesta precisa.

Transportes de MCP compatibles

Este servidor admite dos protocolos de comunicación MCP estándar:

• stdio: Es el transporte predeterminado que se usa cuando un cliente invoca el servidor a través de un command. Se comunica a través de los flujos de entrada y salida estándar, lo que lo hace ideal para la ejecución local de la línea de comandos.
• Streamable HTTP: El servidor expone un extremo /mcp que acepta solicitudes POST. Los clientes que se conectan a través de un url usan este método, que es el estándar para las conexiones de servidores remotos. Nuestra implementación admite la transmisión para respuestas interactivas en tiempo real.

Uso

Puedes ejecutar el servidor de MCP de Code Assist en tu máquina de desarrollo local o de forma remota en Google Cloud Run.

Requisitos

Para usar el kit de herramientas de Code Assist de Google Maps Platform, necesitas un entorno con Node.js (se recomienda la versión LTS) y npm instalados para clonar y ejecutar el servidor, así como un cliente de MCP para acceder al servidor.

Usa Code Assist como un servidor de MCP local con transporte stdio (recomendado)

Ejecute el servidor en su máquina local y conecte los clientes utilizando el protocolo stdio para usarlo con IDE asistidos por IA (como VS Code, Android Studio, Cursor) o aplicaciones de IA de escritorio (como Gemini CLI). Esta es la configuración más sencilla y común.

Configura tu cliente

Agregue el servidor al archivo de configuración MCP de su cliente de IA preferido. Encuentre a su cliente a continuación para obtener instrucciones específicas y verificadas.

1. Gemini Code Assist y Gemini CLI

   • Opción 1: Agregue el servidor directamente desde la línea de comandos (suponiendo que ya tiene instalado Gemini CLI):

      gemini mcp add google-maps-platform-code-assist npx -y @googlemaps/code-assist-mcp@latest
     

     • Para verificar la instalación, ejecuta gemini mcp list.
   • Opción 2: Instalar Code Assist como una extensión de Gemini CLI con preámbulo estático, la herramienta MCP y el tema básico de Google Maps:

     gemini extensions install https://github.com/googlemaps/platform-ai.git
     

   • Opción 3 - Agregue manualmente la configuración del servidor MCP a su archivo ~/.gemini/settings.json.

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

2. Claude Code

   • Opción 1 - Agregue el servidor directamente desde su línea de comandos (suponiendo que ya tiene instalado Claude Code):

         claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist-mcp@latest
     

     • Para verificar la instalación, ejecuta claude mcp list.
     • Usuarios de Windows: En Windows nativo (no en WSL), debes usar el wrapper cmd /c para que los comandos npx funcionen correctamente.

     claude mcp add google-maps-platform-code-assist -- cmd /c "npx -y @googlemaps/code-assist-mcp@latest"
     

   • Opción 2: Agrega el servidor de forma manual a tu archivo de configuración de Claude ~/.claude.json

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

3. Cursor

   • <-- Si ya tienes instalado Cursor, haz clic aquí para instalar el MCP de Google Maps Platform Code Assist directamente.
   • De lo contrario, agréguelo al archivo .cursor-settings/mcp.json de su espacio de trabajo.

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

4. Firebase Studio

   • con Code Assist MCP instalado
   • Agrega esto al archivo mcp.json de tu proyecto en la carpeta .idx de tu espacio de trabajo de Firebase Studio.

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

5. Android Studio

   • Crea un archivo mcp.json y colócalo en el directorio de configuración de Android Studio. Agrega el servidor de Code Assist a la lista:

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

6. Cline

   • Opción 1: Instala con la GUI de Cline MCP
   • Opción 2: Instala de forma manual o programática con el archivo de configuración de Cline MCP. El archivo de configuración se encuentra en la siguiente ubicación:
     • 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
     • Agrega lo siguiente a la configuración de MCP en 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

   • Opción 1: Instala con la GUI de Roo MCP
   • Opción 2: Instala de forma manual o programática con el archivo de configuración de Roo Code. El archivo de configuración se encuentra en la siguiente ubicación:
     • 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
     • Agrega lo siguiente a la configuración de MCP en 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

   • Cuando estés en el modo de agente, haz clic en "Herramientas" y, luego, en el encabezado superior "Configurar herramientas" y, por último, en "Instalar desde un nombre de paquete NPM" (consulta las capturas de pantalla a continuación).

   • 
   • 
   • 

   • Ingresa el nombre del paquete @googlemaps/code-assist-mcp y presiona INTRO para aceptar la instalación y usar el puerto predeterminado 3000. Luego, presiona INTRO una última vez para confirmar el cambio.

   • 

9. Windsurf

   • Es similar a las instrucciones de Cursor anteriores.

10. Kilo Code

    • De forma similar a las instrucciones de Cline y Roo Code anteriores

Más información

Para obtener más información sobre la instalación y el uso del kit de herramientas, así como las condiciones de uso, consulta el archivo README del repositorio de GitHub.