Gemini Cloud Assist MCP Server

официальный

MCP-сервер, который подключается к API Gemini Cloud Assist, позволяя управлять и устранять неполадки в вашей среде Google Cloud с помощью естественного языка.

GitHub

Документация

Gemini Cloud Assist MCP-сервер

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

[!WARNING] Уведомление о прекращении поддержки и переходе на удаленный MCP-сервер

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

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

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

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

Чтобы узнать больше о 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: Требуется для включения Cloud Assist API.
- roles/geminicloudassist.user: Требуется для выполнения запросов к Cloud Assist API.

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

Gemini Cloud Assist MCP-сервер использует локальные учетные данные приложения по умолчанию (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-клиента

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

Gemini CLI

Установите MCP-сервер как расширение Gemini CLI:

gemini extensions install https://github.com/GoogleCloudPlatform/gemini-cloud-assist-mcp

В качестве альтернативы вы можете вручную добавить конфигурацию в ваш файл ~/.gemini/settings.json:

"mcpServers": {
  "gemini_cloud_assist": {
    "httpUrl": "https://geminicloudassist.googleapis.com/mcp",
    "authProviderType": "google_credentials",
    "oauth": {
      "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
    },
    "timeout": 600000
  },
  "application_design_center": {
    "httpUrl": "https://designcenter.googleapis.com/mcp",
    "authProviderType": "google_credentials",
    "oauth": {
      "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
    },
    "timeout": 600000
  }
}

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

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

{
  "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

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

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

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

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

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

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

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

Инструменты Gemini Cloud Assist MCP используют файлы 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.
Перед отправкой запроса на включение изменений, пожалуйста, ознакомьтесь с нашим Руководством по участию.

Лицензия

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