Gemini Cloud Assist MCP Server

oficial

Um servidor MCP que se conecta às APIs do Gemini Cloud Assist, permitindo gerenciar e solucionar problemas do seu ambiente Google Cloud usando linguagem natural.

GitHub

Documentação

Servidor MCP Gemini Cloud Assist

[!IMPORTANT] Aviso de Prévia Privada As APIs do servidor MCP Gemini Cloud Assist estão atualmente em Prévia Privada e protegidas por uma lista de permissões. Entre em contato com sua equipe de conta do Google Cloud para solicitar acesso.

[!WARNING] Aviso de Descontinuação e Migração para Servidor MCP Remoto

O servidor MCP Gemini Cloud Assist migrou de uma arquitetura Node.js local para uma arquitetura de Servidor MCP Remoto. O servidor Node.js local mais antigo perderá o suporte nos próximos meses.

Para usar os novos Servidores MCP Remotos, utilize a versão v0.8.0 ou posterior. Se desejar continuar usando o servidor local legado durante a transição, fixe sua configuração em versões mais antigas.

Este servidor conecta clientes do Model Context Protocol (MCP), como o Gemini CLI, às APIs Gemini Cloud Assist. Ele permite que você use linguagem natural para entender, gerenciar e solucionar problemas do seu ambiente Google Cloud diretamente da linha de comando local.

[!NOTE] Os Termos de Serviço da Plataforma Google Cloud (disponíveis em https://cloud.google.com/terms/) e os Termos de Processamento e Segurança de Dados (disponíveis em https://cloud.google.com/terms/data-processing-terms) não se aplicam a nenhum componente do software Servidor MCP Gemini Cloud Assist.

Para saber mais sobre o Gemini Cloud Assist, consulte a visão geral do Gemini Cloud Assist na documentação do Google Cloud.

✨ Principais recursos

Projetar infraestrutura: Criar e arquitetar configurações de infraestrutura para o Google Cloud.
Solucionar problemas: Executar investigações profundas para encontrar a causa raiz de problemas complexos no seu ambiente Google Cloud.
Gerenciar recursos: Criar, atualizar e excluir recursos do Google Cloud diretamente do seu fluxo de trabalho de chat (requer Ações do Agente).
Otimizar custos: Analisar seus gastos, rastrear custos e identificar oportunidades de eficiência, como recursos ociosos.
Obter assistência geral: Fazer perguntas e obter orientação sobre práticas recomendadas, arquiteturas e operações do Google Cloud.

Início rápido

Antes de começar, certifique-se de ter o seguinte configurado:

Google Cloud SDK instalado e configurado.
Um projeto Google Cloud.
Os seguintes papéis do IAM em sua conta de usuário:
- roles/serviceusage.serviceUsageAdmin: Necessário para habilitar as APIs Cloud Assist.
- roles/geminicloudassist.user: Necessário para fazer solicitações às APIs Cloud Assist.

Etapa 1: Autenticar no Google Cloud

O servidor MCP Gemini Cloud Assist usa Credenciais Padrão do Aplicativo (ADC) locais para autenticar com segurança no Google Cloud. Para configurar o ADC, execute os seguintes comandos 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

Configurar seu cliente MCP

A configuração do agente cliente depende de qual agente você está usando.

Gemini CLI

Instale o servidor MCP como uma extensão do Gemini CLI:

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

Como alternativa, você pode adicionar manualmente a configuração ao seu ~/.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

Adicione o seguinte ao seu 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

No seu projeto Google Cloud, crie um ID de cliente OAuth 2.0 para um aplicativo de desktop.
Configure URI://anysphere.cursor-mcp/oauth/callback como a URL de redirecionamento.
Adicione ou mescle o seguinte bloco de configuração:

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

Siga as instruções de configuração para sua aplicação específica:

Claude.ai

Ferramentas MCP

Ferramentas MCP do Gemini Cloud Assist

O Gemini Cloud Assist é um agente acessível por meio de um conjunto de ferramentas MCP. O agente invocado por chamadas de ferramenta MCP faz suas próprias chamadas de ferramenta internamente para o Google Cloud. As seguintes ferramentas MCP são publicadas para consumo dos agentes:

Ferramenta	Descrição
`ask_cloud_assist`	A interface principal para assistência do Google Cloud e para o agente Gemini Cloud Assist. Todas as funcionalidades são acessíveis através desta ferramenta.
`design_infra`	Suporta fluxos de trabalho para projetar e arquitetar infraestrutura no Google Cloud.
`investigate_issue`	Suporta fluxos de trabalho para solução de problemas no Google Cloud. Pode fazer solução de problemas rápida ou mais aprofundada através de um recurso de Investigação.
`invoke_operation`	Suporta fluxos de trabalho para criar, atualizar e excluir recursos no Google Cloud. Funcional apenas quando as Ações do Agente estão habilitadas.
`optimize_costs`	Suporta fluxos de trabalho para analisar, rastrear e otimizar custos do Google Cloud. Fornece detalhamento de gastos e identifica oportunidades de eficiência de custos.

Ferramentas MCP do Application Design Center

As ferramentas MCP do Application Design Center, frequentemente orquestradas pela ferramenta design_infra do GCA, gerenciam o ciclo de vida da aplicação de infraestrutura usando o Application Design Center, incluindo gerenciamento de modelos, conformidade de segurança, remediação e implantação.

Ferramenta	Descrição
`setup_adc`	Inicializa o ambiente do Application Design Center. Esta é uma etapa de configuração única que deve ser realizada antes que outras ferramentas ADC possam ser usadas.
`manage_application`	Gerencia o ciclo de vida de implantação de uma aplicação. Use esta ferramenta para implantar um design verificado usando o Application Design Center ou recuperar o status e os detalhes de uma implantação existente. Esta é a etapa final que transforma seu design em uma infraestrutura implantada no Google Cloud.
`manage_application_template`	Gerencia o conteúdo de Infraestrutura como Código (IaC) do seu design de infraestrutura. Use para salvar o design como um modelo do Application Design Center, exportar o design como arquivos Terraform ou atualizar o design (por exemplo, configurações de componentes, parâmetros, etc.).
`assess_best_practices`	Realiza uma auditoria abrangente de segurança e configuração no design da sua aplicação antes da implantação. Valida o design em relação às estruturas e controles relevantes do Security Command Center, retornando um relatório com descobertas acionáveis para remediação.
`list_application_templates`	Lista todos os designs de aplicação disponíveis.

Nota: Essas ferramentas não devem ser tratadas como APIs estáveis. Os parâmetros podem ser renomeados ou modificados para acomodar as capacidades em evolução do Gemini Cloud Assist.

Habilidades do Agente

As ferramentas MCP do Gemini Cloud Assist utilizam arquivos SKILL.md para instruir seu agente sobre como usar as ferramentas adequadamente. As habilidades ajudam a orientar seu agente sobre como encadear várias ferramentas em um fluxo de trabalho, passar informações locais relevantes para o Gemini Cloud Assist e habilitar a invocação explícita.

Habilidade	Descrição
`designing-and-deploying-infrastructure`	Orienta o agente sobre como projetar, avaliar, implantar e solucionar problemas de infraestrutura em nuvem usando as ferramentas do Application Design Center (ADC) e do Gemini Cloud Assist.
`operating-google-cloud`	Fornece instruções para gerenciar recursos do Google Cloud Platform (GCP) e Kubernetes usando ferramentas MCP especializadas.

Contribuindo

Se você encontrar um bug, registre um problema em nossa página do GitHub Issues.
Antes de enviar um pull request, revise nosso Guia de Contribuição.

Licença

Este projeto está licenciado sob a Licença Apache 2.0 e é fornecido como está, sem garantia ou representação para qualquer uso ou finalidade. Para detalhes, consulte o arquivo LICENSE.