Google Cloud gcloud MCP Server

Что умеет сервер

Сервер gcloud из репозитория googleapis/gcloud-mcp даёт ИИ-ассистентам возможность взаимодействовать с Google Cloud через утилиту gcloud CLI. Авторы описывают три выгоды: управлять облаком на естественном языке вместо запоминания команд и флагов, объединять облачные операции в повторяемые цепочки и снижать порог входа для тех, кто плохо знаком с gcloud. Основной инструмент один, run_gcloud_command, выполняющий команду gcloud, причём часть команд агенту запрещена.

В репозитории размещены и другие серверы. Observability читает журналы, метрики, оповещения и трассировки Google Cloud: список записей и имён журналов, бакеты, представления и приёмники логов, дескрипторы метрик и временные ряды, политики оповещений, трассировки и группы ошибок. Storage управляет бакетами и объектами в Cloud Storage: списки, чтение, запись, копирование, перемещение и удаление, метаданные, права IAM и запросы к Storage Insights. Backup and DR работает с хранилищами резервных копий, планами, источниками данных и восстановлением.

Когда использовать

Подходит, если вы уже работаете в Google Cloud и хотите, чтобы ассистент сам собирал нужные команды gcloud: посмотреть ресурсы проекта, разобраться с логами и метриками, прочитать содержимое бакета, проверить планы резервного копирования. Для сценариев, где важна только аналитика, достаточно подключить отдельный сервер Observability.

README перечисляет и другие серверы Google Cloud вне этого репозитория: Firebase, Cloud Run, GKE, Google Analytics, Security Operations, Genmedia и MCP Toolbox for Databases.

Ограничения и безопасность

Репозиторий находится в предпросмотре, его интерфейсы могут ломаться. В README прямо сказано, что это решение не является официально поддерживаемым продуктом Google и не покрывается условиями Google Cloud, а при изменении спецификации MCP или других продуктов может сломаться.

Права сервера равны правам активной учётной записи gcloud, поэтому для минимальных привилегий советуют входить как сервисный аккаунт через имперсонацию и выдавать ему роль с ограниченными правами. Сервер по умолчанию запрещает команды, не имеющие смысла для агентов: те, что принимают произвольный ввод или запускают интерактивные сессии. Отдельные инструменты Storage и Backup and DR удаляют данные, так что подключайте их только при необходимости. Нужны Node.js 20 или новее и установленный gcloud CLI.

Нужны Node.js версии 20 или выше и gcloud CLI.

Gemini CLI и Gemini Code Assist

Выполните из домашнего каталога команду, которая установит сервер как расширение Gemini CLI для текущего пользователя:

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

Проверить подключение:

gemini mcp list

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

Другие клиенты

Добавьте фрагмент в JSON-конфигурацию клиента:

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

VS Code

Отредактируйте .vscode/mcp.json в рабочей папке или глобальные пользовательские настройки:

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