Kit de herramientas de Code Assist de Google Maps Platform

Descripción

El kit de herramientas de Code Assist de Google Maps Platform es un servidor de Model Context Protocol (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 los ejemplos de código oficiales y actualizados.

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

Los recursos de Google Maps Platform a los que puede acceder el servidor de MCP 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

Desarrolladores

• 🪄 Convierte tu asistente de IA o IDE favorito en un experto de Google Maps Platform. Con Code Assist, los agentes de IA, como la CLI de Gemini, Claude Code y Cursor, pueden generar código y responder preguntas de los desarrolladores basadas en la documentación y las muestras de código oficiales y actualizadas de Google Maps Platform, directamente en tu flujo de trabajo de desarrollo.

• 🚀 Ya sea que realices cambios de código precisos asistidos por IA o que vibecodes un nuevo prototipo de app, Code Assist puede ayudarte a completar tu tarea de forma más rápida y sencilla.

🔧 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 la mejor manera de razonar la intención del usuario y formular llamadas eficaces a la herramienta 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 de RAG busca versiones actualizadas de la documentación oficial, los instructivos y las muestras de código de Google Maps Platform, y devuelve contexto pertinente a la IA para generar una respuesta precisa.

🛠️ Transports de MCP compatibles

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

• stdio: Este 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 de 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)

Ejecuta el servidor en tu máquina local y conecta clientes con el protocolo stdio para usarlo con IDE asistidos por IA (como VS Code, Android Studio, Cursor) o aplicaciones de IA para computadoras (como la CLI de Gemini). Esta es la configuración más simple y común.

Configura tu cliente

Agrega el servidor al archivo de configuración de MCP de tu cliente de IA preferido. Busca tu cliente a continuación para obtener instrucciones específicas y verificadas.

1. Gemini Code Assist y Gemini CLI

   • Opción 1: Agrega el servidor directamente desde la línea de comandos (si ya tienes instalada la CLI de Gemini):

      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: Agrega manualmente la configuración del servidor de MCP a tu 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: Agrega el servidor directamente desde la línea de comandos (si ya tienes instalado Claude Code):

         claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist@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-mc@latest"
         ]
       }
     }
   

3. Cursor

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

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

4. Firebase Studio

   • con el MCP de Code Assist instalado
   • Agrega 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 MCP de Cline. 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 Agente, haz clic en "Herramientas" y, luego, en el encabezado superior "Configurar herramientas" y, luego, 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.