Repolode
googleapis

googleapis/gcloud-mcp

Servidor MCP que permite a assistentes de IA executar comandos do gcloud CLI e consultar Google Cloud Observability, Cloud Storage e Backup and DR em linguagem natural.

Estrelas
931
Forks
83
Issues abertas
69
Último commit
há 5 dias

O que é?

gcloud MCP é um servidor Model Context Protocol que conecta assistentes de IA ao Google Cloud por meio do gcloud CLI. Em vez de memorizar a sintaxe dos comandos, as flags e os argumentos, os usuários descrevem o que querem fazer, e o assistente executa as operações correspondentes do gcloud.

O repositório contém vários servidores: gcloud, para executar comandos do gcloud; observability, para consultar logs, métricas, traces e grupos de erros; storage, para gerenciar buckets e objetos do Cloud Storage; e backupdr, para trabalhar com vaults, planos e backups do Backup and Disaster Recovery. Cada servidor é publicado como um pacote npm no escopo @google-cloud e pode ser iniciado com npx.

A configuração é voltada para Gemini CLI e Gemini Code Assist e inclui trechos para configuração manual no Claude Desktop, Cline, Cursor e Visual Studio Code. Requer Node.js 20 ou posterior e o gcloud CLI. Alguns comandos do gcloud interativos ou que aceitam entradas arbitrárias são bloqueados por padrão, e o acesso é limitado pelas permissões da conta ativa do gcloud.

Recursos principais

  • 01Executa comandos do gcloud CLI a partir de prompts em linguagem natural, usando a ferramenta run_gcloud_command.
  • 02Consulta logs do Cloud Logging, métricas do Cloud Monitoring, traces e grupos de erros.
  • 03Lista, lê, envia, baixa, copia e move objetos do Cloud Storage.
  • 04Gerencia buckets, políticas de IAM e consultas do Storage Insights.
  • 05Inspeciona e opera vaults, planos e backups do Backup and Disaster Recovery.

Casos de uso

  • Permitir que desenvolvedores sem familiaridade com o gcloud realizem tarefas comuns na nuvem usando um assistente de IA.
  • Investigar problemas em produção consultando logs, traces e métricas por meio de uma conversa.
  • Encadear várias operações do Cloud Storage ou de backup em um único fluxo de trabalho reproduzível.
  • Executar comandos do gcloud com uma conta de serviço restrita, usando impersonation.

Início rápido

  1. 1

    Pré-requisitos: instale o Node.js 20 ou superior e a gcloud CLI

  2. 2

    Adicione o servidor gcloud MCP à configuração do seu cliente de IA (por exemplo, Claude Desktop, Cline, Cursor ou VS Code)

    npx -y @google-cloud/gcloud-mcp
  3. 3

    Ou, se estiver usando o Gemini CLI, execute o comando de configuração no diretório inicial

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

Antes de usar

  • É necessário ter a gcloud CLI instalada e configurada, além do Node.js 20 ou superior.
  • Os comandos executados pelo agente podem operar em recursos reais do Google Cloud; por isso, o acesso deve ser limitado com cuidado.

Em coleções

Tópicos

Perguntas frequentes

O que é gcloud-mcp?
Servidor MCP que permite a assistentes de IA executar comandos do gcloud CLI e consultar Google Cloud Observability, Cloud Storage e Backup and DR em linguagem natural. gcloud MCP é um servidor Model Context Protocol que conecta assistentes de IA ao Google Cloud por meio do gcloud CLI. Em vez de memorizar a sintaxe dos comandos, as flags e os argumentos, os usuários descrevem o que querem fazer, e o assistente executa as operações correspondentes do gcloud.
gcloud-mcp é gratuito? Qual é a licença?
gcloud-mcp é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
gcloud-mcp ainda é mantido?
Manutenção ativa. O último commit de gcloud-mcp foi em 17 de out. de 2026.
Para que posso usar gcloud-mcp?
Permitir que desenvolvedores sem familiaridade com o gcloud realizem tarefas comuns na nuvem usando um assistente de IA. Investigar problemas em produção consultando logs, traces e métricas por meio de uma conversa. Encadear várias operações do Cloud Storage ou de backup em um único fluxo de trabalho reproduzível. Executar comandos do gcloud com uma conta de serviço restrita, usando impersonation.
Como instalar gcloud-mcp?
Pré-requisitos: instale o Node.js 20 ou superior e a gcloud CLI Adicione o servidor gcloud MCP à configuração do seu cliente de IA (por exemplo, Claude Desktop, Cline, Cursor ou VS Code): npx -y @google-cloud/gcloud-mcp Ou, se estiver usando o Gemini CLI, execute o comando de configuração no diretório inicial: npx @google-cloud/gcloud-mcp init --agent=gemini-cli
Onde consigo gcloud-mcp?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/googleapis/gcloud-mcp

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados