Gemini Cloud Assist

MCP-сервер Gemini Cloud Assist

[!IMPORTANT] Уведомление о приватном предварительном просмотре API MCP-сервера Gemini Cloud Assist в настоящее время находятся в приватном предварительном просмотре и доступны по списку разрешений. Пожалуйста, свяжитесь с командой вашего аккаунта Google Cloud, чтобы запросить доступ.

[!WARNING] Уведомление об устаревании и переходе на удалённый MCP-сервер

MCP-сервер Gemini Cloud Assist перешёл с локальной архитектуры Node.js на архитектуру удалённого MCP-сервера. Более старый локальный сервер Node.js потеряет поддержку в ближайшие месяцы.

Чтобы использовать новые удалённые MCP-серверы, используйте версию v0.8.0 или более позднюю. Если вы хотите продолжать использовать устаревший локальный сервер в течение переходного периода, закрепите свою конфигурацию на более старых версиях.

Этот сервер подключает клиенты Model Context Protocol (MCP) к API Gemini Cloud Assist. Он позволяет использовать естественный язык для понимания, управления и устранения неполадок в вашей среде Google Cloud непосредственно из локальной командной строки.

[!NOTE] Условия предоставления услуг Google Cloud Platform (доступны по адресу https://cloud.google.com/terms/) и Условия обработки данных и безопасности (доступны по адресу https://cloud.google.com/terms/data-processing-terms) не применяются ни к какому компоненту программного обеспечения MCP-сервера Gemini Cloud Assist.

Чтобы узнать больше о Gemini Cloud Assist, см. обзор Gemini Cloud Assist в документации Google Cloud.

✨ Ключевые возможности

• Проектирование инфраструктуры: Создание и архитектура конфигураций инфраструктуры для Google Cloud.
• Устранение неполадок: Проведение углублённых расследований для поиска первопричины сложных проблем в вашей среде Google Cloud.
• Управление ресурсами: Создание, обновление и удаление ресурсов Google Cloud непосредственно из вашего чат-процесса (требуется Agent Actions).
• Оптимизация затрат: Анализ расходов, отслеживание затрат и выявление возможностей для повышения эффективности, таких как неиспользуемые ресурсы.
• Общая помощь: Ответы на вопросы и получение рекомендаций по лучшим практикам, архитектурам и операциям Google Cloud.

Быстрый старт

Перед началом убедитесь, что у вас настроено следующее:

• Установлен и настроен Google Cloud SDK.
• Проект Google Cloud.
• Следующие роли IAM в вашей учётной записи:
  • roles/serviceusage.serviceUsageAdmin: Требуется для включения API Cloud Assist.
  • roles/geminicloudassist.user: Требуется для выполнения запросов к API Cloud Assist.

Шаг 1: Аутентификация в Google Cloud

MCP-сервер Gemini Cloud Assist использует локальные учётные данные приложения по умолчанию (ADC) для безопасной аутентификации в Google Cloud. Чтобы настроить ADC, выполните следующие команды gcloud:

# Authenticate your user account to the gcloud CLI
gcloud auth login

# Set up Application Default Credentials for the server.
gcloud auth application-default login

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

Конфигурация клиент-агента зависит от того, какой агент вы используете.

Antigravity

Добавьте следующее в ваш mcp_config.json:

"mcpServers": {
  "gemini_cloud_assist": {
    "serverUrl": "https://geminicloudassist.googleapis.com/mcp",
    "headers": {},
    "authProviderType": "google_credentials"
  },
  "application_design_center": {
    "serverUrl": "https://designcenter.googleapis.com/mcp",
    "headers": {},
    "authProviderType": "google_credentials"
  }
}

Cursor

1. В вашем проекте Google Cloud создайте идентификатор клиента OAuth 2.0 для настольного приложения.
2. Настройте URI://anysphere.cursor-mcp/oauth/callback в качестве URL перенаправления.
3. Добавьте или объедините следующий блок конфигурации:

{
  "mcpServers": {
    "gemini_cloud_assist": {
      "url": "https://geminicloudassist.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    },
    "application_design_center": {
      "url": "https://designcenter.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    }
  }
}

Claude

Следуйте инструкциям по настройке для вашего конкретного приложения:

• Claude.ai

Инструменты MCP

Инструменты MCP Gemini Cloud Assist

Gemini Cloud Assist — это агент, доступный через набор инструментов MCP. Агент, вызываемый через вызовы инструментов MCP, сам выполняет внутренние вызовы инструментов в Google Cloud. Следующие инструменты MCP опубликованы для использования агентами:

Инструмент	Описание
ask_cloud_assist	Основной интерфейс для помощи в Google Cloud и для агента Gemini Cloud Assist. Все функции доступны через этот инструмент.
design_infra	Поддерживает рабочие процессы проектирования и архитектуры инфраструктуры в Google Cloud.
investigate_issue	Поддерживает рабочие процессы устранения неполадок в Google Cloud. Может выполнять быстрое устранение неполадок или более глубокое расследование через ресурс Investigation.
invoke_operation	Поддерживает рабочие процессы создания, обновления и удаления ресурсов в Google Cloud. Работает только при включённых Agent Actions.
optimize_costs	Поддерживает рабочие процессы анализа, отслеживания и оптимизации затрат Google Cloud. Предоставляет разбивку расходов и выявляет возможности для повышения экономической эффективности.

Инструменты MCP Application Design Center

Инструменты Application Design Center MCP, часто оркеструемые инструментом design_infra GCA, управляют жизненным циклом инфраструктурных приложений с помощью Application Design Center, включая управление шаблонами, обеспечение безопасности и соответствия требованиям, а также развёртывание.

Инструмент	Описание
setup_adc	Инициализирует среду Application Design Center. Это одноразовый шаг настройки, который необходимо выполнить перед использованием других инструментов ADC.
manage_application	Управляет жизненным циклом развёртывания приложения. Используйте этот инструмент для развёртывания проверенного проекта с помощью Application Design Center или для получения статуса и деталей существующего развёртывания. Это финальный шаг, который превращает ваш проект в развёрнутую инфраструктуру в Google Cloud.
manage_application_template	Управляет содержимым Infrastructure as Code (IaC) вашего инфраструктурного проекта. Используйте это для сохранения проекта в качестве шаблона Application Design Center, экспорта проекта в виде файлов Terraform или обновления проекта (например, компонентов, конфигураций параметров и т. д.).
assess_best_practices	Выполняет всесторонний аудит безопасности и конфигурации вашего проекта приложения перед развёртыванием. Проверяет проект на соответствие фреймворкам Security Command Center и соответствующим средствам контроля, возвращая отчёт с действенными выводами для исправления.
list_application_templates	Перечисляет все доступные проекты приложений.

Примечание: Эти инструменты не следует рассматривать как стабильные API. Параметры могут быть переименованы или изменены с учётом развивающихся возможностей Gemini Cloud Assist.

Навыки агента

Инструменты MCP Gemini Cloud Assist используют файлы SKILL.md для инструктажа вашего агента о том, как правильно использовать инструменты. Навыки помогают направлять вашего агента на объединение нескольких инструментов в рабочий процесс, передачу соответствующей локальной информации в Gemini Cloud Assist и обеспечение явного вызова.

Навык	Описание
designing-and-deploying-infrastructure	Направляет агента по проектированию, оценке, развёртыванию и устранению неполадок облачной инфраструктуры с помощью Application Design Center (ADC) и инструментов Gemini Cloud Assist.
operating-google-cloud	Предоставляет инструкции по управлению ресурсами Google Cloud Platform (GCP) и Kubernetes с помощью специализированных инструментов MCP.

Вклад в проект

• Если вы обнаружили ошибку, пожалуйста, сообщите о проблеме на нашей странице GitHub Issues.
• Перед отправкой pull request, пожалуйста, ознакомьтесь с нашим Руководством по внесению вклада.

Лицензия

Этот проект лицензирован в соответствии с лицензией Apache 2.0 и предоставляется как есть, без каких-либо гарантий и заявлений относительно любого использования или цели. Подробности см. в файле LICENSE.