Набор инструментов Code Assist для платформы Google Карт

Описание

Набор инструментов Google Maps Platform Code Assist представляет собой сервер Model Context Protocol (MCP), который улучшает ответы больших языковых моделей (LLM), используемых для разработки приложений с помощью Google Maps Platform, основывая ответы на официальной актуальной документации и примерах кода.

Поскольку сервер MCP обращается к контенту при запросе модели, контекст LLM относительно платформы Google Maps не обязательно должен ограничиваться доступными данными на дату обучения модели.

Ресурсы платформы Google Maps, к которым может получить доступ сервер MCP, включают:

  • Документация платформы Google Карт
  • Условия обслуживания платформы Google Карт
  • Центр управления безопасностью платформы Google Карт
  • Репозитории кода в официальных организациях GitHub платформы Google Карт

Разработчики

  • 🪄 Сделайте своего любимого ИИ-помощника или IDE экспертом по платформе Google Карт. С Code Assist ИИ-агенты, такие как Gemini CLI, Claude Code и Cursor, могут генерировать код и отвечать на вопросы разработчиков, основываясь на актуальной официальной документации и примерах кода платформы Google Карт — прямо в процессе разработки.

  • 🚀 Независимо от того, вносите ли вы точные изменения в код с помощью ИИ или пишете код для нового прототипа приложения, Code Assist поможет вам выполнить вашу задачу быстрее и проще.

🔧 Предоставляемые инструменты

Сервер MCP предоставляет следующие инструменты для клиентов ИИ:

  1. retrieve-instructions : вспомогательный инструмент, используемый клиентом для получения важнейших системных инструкций о том, как лучше всего проанализировать намерения пользователя и сформулировать эффективные вызовы инструмента retrieve-google-maps-platform-docs .
  2. retrieve-google-maps-platform-docs : основной инструмент. Он принимает запрос на естественном языке и отправляет его в размещенный механизм поиска дополненной реальности (RAG). Механизм RAG ищет актуальные версии официальной документации, учебных пособий и примеров кода платформы Google Карт, возвращая ИИ соответствующий контекст для генерации точного ответа.

🛠️ Поддерживаемые транспорты MCP

Этот сервер поддерживает два стандартных протокола связи MCP:

  • stdio : это транспорт по умолчанию, используемый при вызове клиентом сервера через command . Он взаимодействует через стандартные потоки ввода/вывода, что делает его идеальным для локального выполнения команд из командной строки.
  • Streamable HTTP : сервер предоставляет конечную точку /mcp , принимающую POST-запросы. Она используется клиентами, подключающимися по url , и является стандартом для подключений к удалённому серверу. Наша реализация поддерживает потоковую передачу для интерактивных ответов в режиме реального времени.

🚀 Использование

Вы можете запустить сервер Code Assist MCP либо на локальной машине разработки, либо удаленно в Google Cloud Run.

Требования

Чтобы использовать набор инструментов Google Maps Platform Code Assist, вам понадобится среда с установленными Node.js (рекомендуется версия LTS) и npm для клонирования и запуска сервера, а также клиент MCP для доступа к серверу.

Запустите сервер на локальном компьютере и подключайте клиентов по протоколу stdio для использования с IDE с поддержкой ИИ (например, VS Code, Android Studio, Cursor) или десктопными приложениями ИИ (например, Gemini CLI). Это самая простая и распространённая конфигурация.

Настройте своего клиента

Добавьте сервер в файл конфигурации MCP вашего предпочитаемого ИИ-клиента. Найдите свой клиент ниже, чтобы получить подробные, проверенные инструкции.

  1. Gemini Code Assist и Gemini CLI

    • Вариант 1. Добавьте сервер непосредственно из командной строки (при условии, что у вас уже установлен Gemini CLI):
       gemini mcp add google-maps-platform-code-assist npx -y @googlemaps/code-assist-mcp@latest
      
      • Проверьте установку, запустив gemini mcp list .
    • Вариант 2. Добавьте конфигурацию сервера MCP вручную в файл ~/.gemini/settings.json .
    {
      "mcpServers": {
        "google-maps-platform-code-assist": {
          "command": "npx",
          "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
        }
      }
    }
    
  2. Клод Код

    • Вариант 1. Добавьте сервер непосредственно из командной строки (при условии, что у вас уже установлен Claude Code):
          claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist@latest
      
      • Проверьте установку, запустив claude mcp list .
      • Пользователи Windows: в Windows (не WSL) для корректной работы команд npx необходимо использовать оболочку cmd /c для корректной работы команд npx .
      claude mcp add google-maps-platform-code-assist -- cmd /c "npx -y @googlemaps/code-assist-mcp@latest"
      
    • Вариант 2. Добавить сервер вручную в файл конфигурации Claude ~/.claude.json
    "mcpServers": {
        "google-maps-platform-code-assist": {
          "command": "npx",
          "args": [
            "-y", "@googlemaps/code-assist-mc@latest"
          ]
        }
      }
    
  3. Курсор

    • Установить MCP-сервер <-- Если у вас уже установлен Cursor, нажмите здесь, чтобы напрямую установить Google Maps Platform Code Assist MCP.
    • В противном случае добавьте его в файл .cursor-settings/mcp.json вашего рабочего пространства.
    {
      "mcpServers": {
        "google-maps-platform-code-assist": {
          "command": "npx",
          "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
        }
      }
    }
    
  4. Студия Firebase

    • Попробуйте в Firebase Studio с установленным Code Assist MCP
    • Добавьте в файл mcp.json вашего проекта в папке .idx в рабочей области Firebase Studio
    {
      "mcpServers": {
        "google-maps-platform-code-assist": {
          "command": "npx",
          "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
        }
      }
    }
    
  5. Android Studio

    {
      "mcpServers": {
        "google-maps-platform-code-assist": {
          "command": "npx",
          "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
        }
      }
    }
    
  6. Клайн

    • Вариант 1: установка с помощью графического интерфейса Cline MCP
    • Вариант 2: ручная/программная установка с помощью файла конфигурации Cline MCP. Файл конфигурации находится по адресу:
      • 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
      • Добавьте следующее в конфигурацию MCP в 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. Ру Код

    • Вариант 1: установка с помощью графического интерфейса Roo MCP
    • Вариант 2: ручная/программная установка с помощью файла конфигурации Roo Code. Файл конфигурации находится по адресу:
      • 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
      • Добавьте следующее в конфигурацию MCP в 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

    • В режиме агента нажмите «Инструменты», затем в верхнем заголовке «Настроить инструменты», затем «Установить из имени пакета NPM» (см. скриншоты ниже).

    • изображение
    • изображение
    • изображение
    • Введите имя пакета @googlemaps/code-assist-mcp и нажмите ENTER, чтобы принять установку и использовать порт по умолчанию 3000, затем нажмите ENTER еще раз, чтобы подтвердить изменение.

    • изображение
  9. Виндсерфинг

    • Аналогично инструкциям курсора, приведенным выше.
  10. Кило-код

    • Аналогично инструкциям по коду Клайна и Ру, приведенным выше.

Узнать больше

Дополнительную информацию об установке и использовании инструментария, а также условия использования см. в файле README репозитория GitHub.