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

Набор инструментов 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 Карт

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

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

retrieve-instructions : вспомогательный инструмент, используемый клиентом для получения важнейших системных инструкций о том, как лучше всего проанализировать намерения пользователя и сформулировать эффективные вызовы инструмента retrieve-google-maps-platform-docs .
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 для доступа к серверу.

Использовать 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 как расширения Gemini CLI со статической преамбулой, инструментом MCP и базовой темой Google Maps:
```
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 для корректной работы команд 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-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
- с установленным 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 еще раз, чтобы подтвердить изменение.
Виндсерфинг
- Аналогично инструкциям курсора, приведенным выше.
Кило-код
- Аналогично инструкциям по коду Клайна и Ру, приведенным выше.

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

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

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