Описание
Набор инструментов 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 предоставляет следующие инструменты для клиентов ИИ:
-
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. Добавьте конфигурацию сервера MCP вручную в файл
~/.gemini/settings.json
.
{ "mcpServers": { "google-maps-platform-code-assist": { "command": "npx", "args": ["-y", "@googlemaps/code-assist-mcp@latest"] } } }
- Вариант 1. Добавьте сервер непосредственно из командной строки (при условии, что у вас уже установлен Gemini CLI):
- Вариант 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" ] } }
- Вариант 1. Добавьте сервер непосредственно из командной строки (при условии, что у вас уже установлен Claude Code):
-
<-- Если у вас уже установлен 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"] } } }
-
-
с установленным Code Assist MCP
- Добавьте в файл
mcp.json
вашего проекта в папке.idx
в рабочей области Firebase Studio
{ "mcpServers": { "google-maps-platform-code-assist": { "command": "npx", "args": ["-y", "@googlemaps/code-assist-mcp@latest"] } } }
-
- Создайте файл
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" ] } }
- macOS:
- Вариант 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" ] } }
- macOS:
В режиме агента нажмите «Инструменты», затем в верхнем заголовке «Настроить инструменты», затем «Установить из имени пакета NPM» (см. скриншоты ниже).
Введите имя пакета
@googlemaps/code-assist-mcp
и нажмите ENTER, чтобы принять установку и использовать порт по умолчанию 3000, затем нажмите ENTER еще раз, чтобы подтвердить изменение.
- Аналогично инструкциям курсора, приведенным выше.
- Аналогично инструкциям по коду Клайна и Ру, приведенным выше.
Узнать больше
Дополнительную информацию об установке и использовании инструментария, а также условия использования см. в файле README репозитория GitHub.