Google Cloud MCP Server

официальный

Взаимодействуйте с сервисами Google Cloud и управляйте своими облачными ресурсами.

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

gcloud MCP-сервер ☁️

gcloud Model Context Protocol (MCP) сервер позволяет AI-ассистентам легко взаимодействовать с окружением Google Cloud с помощью gcloud CLI. С gcloud MCP-сервером вы можете:

Взаимодействовать с Google Cloud на естественном языке. Описывайте желаемый результат вместо запоминания сложного синтаксиса команд, флагов и аргументов.
Автоматизировать и упрощать сложные рабочие процессы. Объединяйте несколько облачных операций в одну повторяемую команду, чтобы сократить ручной труд и вероятность ошибок.
Снизить порог входа в управление облаком. Дайте возможность членам команды, менее знакомым с gcloud, уверенно и безопасно выполнять сложные действия.

📡 Доступные MCP-серверы

Этот репозиторий также содержит другие MCP-серверы помимо gcloud MCP-сервера. Актуальный список приведён ниже, а ссылки на другие Google Cloud MCP-серверы, размещённые вне этого репозитория, находятся здесь.

Название MCP-сервера	Описание	Имя пакета
gcloud	Взаимодействие с Google Cloud через gcloud CLI с помощью подсказок на естественном языке.	`gcloud-mcp`
observability	Доступ к API Google Cloud Observability для запросов логов, метрик и трассировок.	`observability-mcp`
storage	Взаимодействие с Google Cloud Storage для управления бакетами и объектами.	`storage-mcp`
backupdr	Взаимодействие с Google Cloud Backup and Disaster Recovery.	`backupdr-mcp`

🚀 Начало работы

Предварительные требования

Node.js: версия 20 или выше
gcloud CLI

✨ Настройка вашего MCP-сервера

Gemini CLI и Gemini Code Assist

Чтобы интегрировать MCP-серверы с Gemini CLI или Gemini Code Assist, выполните приведённую ниже команду настройки из вашего домашнего каталога для MCP-сервера, указанного в таблице. Это установит MCP-сервер как расширение Gemini CLI для текущего пользователя, делая его доступным для всех ваших проектов.

npx @google-cloud/[PACKAGE_NAME] init --agent=gemini-cli

Например, для gcloud-mcp:

npx @google-cloud/gcloud-mcp init --agent=gemini-cli

После процесса инициализации вы можете проверить, что gcloud-mcp сервер настроен правильно, выполнив следующую команду:

gemini mcp list

> ✓ gcloud: npx -y @google-cloud/gcloud-mcp (stdio) - Connected

Для других AI-клиентов

Чтобы использовать MCP-серверы из этого репозитория с другими клиентами, добавьте следующий фрагмент в их соответствующие JSON-файлы конфигурации для каждого MCP-сервера:

"[SERVER_NAME]": {
  "command": "npx",
  "args": ["-y", "@google-cloud/[PACKAGE_NAME]"]
}

Например, для gcloud:

"gcloud": {
  "command": "npx",
  "args": ["-y", "@google-cloud/gcloud-mcp"]
}

Инструкции для популярных инструментов:

Claude Desktop: Откройте Claude > Settings > Developer > Edit Config и отредактируйте claude_desktop_config.json.
Cline: Нажмите иконку MCP Servers, затем Configure MCP Servers, чтобы отредактировать cline_mcp_settings.json.
Cursor: Отредактируйте .cursor/mcp.json для одного проекта или ~/.cursor/mcp.json для всех проектов.
Gemini CLI (Ручная настройка): Если не используете расширения, отредактируйте .gemini/settings.json для одного проекта или ~/.gemini/settings.json для всех проектов.

Для Visual Studio Code отредактируйте файл .vscode/mcp.json в вашем рабочем пространстве для одного проекта или файл глобальных пользовательских настроек для всех проектов:

"servers": {
  "[SERVER_NAME]": {
    "command": "npx",
    "args": ["-y", "@google-cloud/[PACKAGE_NAME]"]
  }
}

Например, для gcloud и observability:

"servers": {
  "gcloud": {
    "command": "npx",
    "args": ["-y", "@google-cloud/gcloud-mcp"]
  },
  "observability": {
    "command": "npx",
    "args": ["-y", "@google-cloud/observability-mcp"]
  },
}

🛠 Локальная разработка

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

🧰 Доступные инструменты MCP

MCP-сервер	Инструмент	Описание
gcloud	`run_gcloud_command`	Выполняет команду gcloud. Некоторые команды ограничены для выполнения агентом. Подробнее см. Разрешения MCP.
observability	`list_log_entries`	Выводит записи журнала из проекта.
	`list_log_names`	Выводит имена журналов из проекта.
	`list_buckets`	Выводит корзины журналов из проекта.
	`list_views`	Выводит представления журналов из проекта.
	`list_sinks`	Выводит приёмники журналов из проекта.
	`list_log_scopes`	Выводит области журналов из проекта.
	`list_metric_descriptors`	Выводит дескрипторы метрик для проекта.
	`list_time_series`	Выводит данные временных рядов для указанной метрики.
	`list_alert_policies`	Выводит политики оповещения в проекте.
	`list_traces`	Ищет трассировки в проекте.
	`get_trace`	Получает конкретную трассировку по идентификатору в проекте.
	`list_group_stats`	Выводит группы ошибок для проекта.
storage	`list_objects`	Выводит объекты в корзине GCS.
	`read_object_metadata`	Читает полные метаданные конкретного объекта.
	`read_object_content`	Читает содержимое конкретного объекта.
	`delete_object`	Удаляет конкретный объект из корзины.
	`write_object`	Записывает новый объект в корзину.
	`update_object_metadata`	Обновляет пользовательские метаданные существующего объекта.
	`copy_object`	Копирует объект из одной корзины в другую.
	`move_object`	Перемещает объект из одной корзины в другую.
	`upload_object`	Загружает файл в корзину GCS.
	`download_object`	Скачивает объект из GCS в локальный файл.
	`list_buckets`	Выводит все корзины в проекте.
	`create_bucket`	Создаёт новую корзину.
	`delete_bucket`	Удаляет корзину.
	`get_bucket_metadata`	Получает полные метаданные конкретной корзины.
	`update_bucket_labels`	Обновляет метки корзины.
	`get_bucket_location`	Получает местоположение корзины.
	`view_iam_policy`	Просматривает политику IAM для корзины.
	`check_iam_permissions`	Проверяет разрешения IAM для корзины.
	`get_metadata_table_schema`	Проверяет, включена ли служба GCS Insights, и возвращает схему таблицы BigQuery для заданной конфигурации набора данных Insights.
	`execute_insights_query`	Выполняет SQL-запрос BigQuery к набору данных Insights и возвращает результат.
	`list_insights_configs`	Выводит имена всех конфигураций наборов данных Storage Insights для указанного проекта.
backupdr	`list_backup_vaults`	Выводит все резервные хранилища в указанном проекте и местоположении.
	`get_backup_vault`	Получает сведения о конкретном резервном хранилище.
	`list_backup_plans`	Выводит все планы резервного копирования в указанном проекте и местоположении.
	`get_backup_plan`	Получает сведения о конкретном плане резервного копирования.
	`list_backup_plan_associations`	Выводит все связи между планами резервного копирования и ресурсами.
	`get_backup_plan_association`	Получает сведения о конкретной связи плана резервного копирования.
	`list_datasources`	Выводит все источники данных в резервном хранилище.
	`get_datasource`	Получает сведения о конкретном источнике данных.
	`list_backups`	Выводит все резервные копии для указанного источника данных.
	`get_backup`	Получает сведения о конкретной резервной копии.
	`find_protectable_resources`	Обнаруживает ресурсы (ВМ, диски, SQL), которые можно защитить.
	`get_backupdr_operation`	Получает статус длительной операции BackupDR.
	`get_csql_operation`	Получает статус длительной операции Cloud SQL.
	`create_backup_vault`	Создаёт новое резервное хранилище в указанном местоположении.
	`create_backup_plan`	Создаёт новый план резервного копирования с заданными правилами и сроком хранения.
	`update_backup_plan`	Изменяет существующий план резервного копирования.
	`create_backup_plan_association`	Связывает ресурс с планом резервного копирования для начала защиты.
	`restore_backup`	Восстанавливает резервную копию на целевой экземпляр или диск Compute Engine.
	`csql_restore`	Восстанавливает резервную копию Cloud SQL на целевой экземпляр.
	`delete_backup_vault`	Удаляет резервное хранилище.
	`delete_backup_plan`	Удаляет план резервного копирования.
	`delete_backup_plan_association`	Снимает защиту с ресурса, удаляя его связь.
	`delete_backup`	Удаляет указанную резервную копию из хранилища.

🔑 Разрешения MCP

Разрешения gcloud MCP напрямую связаны с разрешениями активной учетной записи gcloud. Чтобы ограничить разрешения и работать по принципу наименьших привилегий, вы можете авторизоваться как сервисная учетная запись с использованием имперсонации и назначить сервисной учетной записи роль с ограниченными разрешениями.

По умолчанию gcloud MCP предотвращает выполнение команд gcloud, которые не имеют смысла для AI-агентов. Это сделано для ограничения команд, способных выполнять произвольные входные данные и инициировать интерактивные сессии. См. здесь список запрещенных команд.

💫 Другие серверы Google Cloud MCP

Google Cloud предлагает следующие серверы:

👥 Участие в проекте

Мы приветствуем вклад! Будь то исправление ошибок, обмен отзывами или улучшение документации — ваш вклад приветствуется. Пожалуйста, ознакомьтесь с нашим Руководством по участию, чтобы начать.

📄 Важные примечания

Этот репозиторий в настоящее время находится в предварительной версии и может претерпеть критические изменения. Этот репозиторий предоставляет решение, а не официально поддерживаемый продукт Google. Он не подпадает под действие Условий предоставления услуг Google Cloud. Он может сломаться при изменении спецификации MCP, других SDK или других решений и продуктов. См. также нашу Политику безопасности.