Эта страница переведена с помощью Cloud Translation API.

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

Описание

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

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

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

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

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

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

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

Поддерживаемые 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 для доступа к серверу.

Используйте Code Assist в качестве локального MCP-сервера с передачей данных по протоколу `stdio` (рекомендуется).

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

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

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

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 — Установите сервер Code Assist MCP в качестве расширения Gemini CLI:
```
gemini extensions install https://github.com/googlemaps/platform-ai.git
```
- Вариант 3 — Добавьте конфигурацию сервера MCP вручную в файл ~/.gemini/settings.json .
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}
```
Кодекс Клода
- Вариант 1 — Добавить сервер непосредственно из командной строки (при условии, что у вас уже установлен Claude Code):
```
    claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist-mcp@latest
```
  - Проверьте установку, выполнив команду claude mcp list .
  - Пользователям Windows: В нативной Windows (не WSL) для корректной работы команд npx необходимо использовать оболочку cmd /c .
```
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-mcp@latest"
      ]
    }
  }
```
Курсор
- <-- Если у вас уже установлен 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"]
    }
  }
}
```
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"]
    }
  }
}
```
Android Studio
- Создайте файл mcp.json и поместите его в каталог конфигурации Android Studio. Добавьте сервер Code Assist в список:
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}
```
Клайн
- Вариант 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"
      ]
    }
  }
}
```
Кодекс Ру
- Вариант 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"
      ]            
    }
  }
}
```
Microsoft Copilot
- В режиме агента нажмите «Инструменты», затем в верхнем заголовке «Настроить инструменты», после чего выберите «Установить из имени пакета NPM» (см. скриншоты ниже).
- Введите имя пакета @googlemaps/code-assist-mcp и нажмите ENTER, подтвердив установку и использование порта по умолчанию 3000, затем нажмите ENTER еще раз для подтверждения изменения.
Виндсёрфинг
- Аналогично инструкциям по использованию курсора, приведенным выше.
Килокод
- Аналогично инструкциям по кодам Cline и Roo, приведенным выше.

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

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

Набор инструментов Code Assist для платформы Google Карт Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.