关键词

Google CloudAI助理故障排除资源管理LLM工具调用

项目简介

Gemini Cloud Assist MCP服务器是一个基于Model Context Protocol (MCP) 实现的后端服务，旨在将大语言模型（LLM）客户端（如Gemini CLI、Cursor、Claude等）与Google Cloud的Gemini Cloud Assist API连接起来。它使用户能够通过自然语言指令，方便地理解、管理和排查其Google Cloud环境中的问题。

主要功能点

  • 创建和运行调查: 启动并执行Cloud Assist调查，以诊断复杂问题的根本原因。
  • 深入分析和迭代调查: 获取调查结果的更多详细信息，并添加新的观察结果以优化分析。
  • 查找和分析Google Cloud资源: 快速检查您的Cloud资源和应用程序的状态与性能。

安装步骤

  1. 前提条件: 确保已安装Node.js (v20或更高版本)、Git和Google Cloud SDK，并已配置好一个Google Cloud项目。您的Google Cloud用户账户需要'roles/serviceusage.serviceUsageAdmin'（用于启用Cloud Assist API）和'roles/geminicloudassist.user'（用于调用Cloud Assist API）这两个IAM角色。
  2. 认证Google Cloud: 运行以下'gcloud'命令以设置应用默认凭据 (ADC)，使MCP服务器能够代表您安全地调用Google Cloud API： 
    gcloud auth login
gcloud auth application-default login
  3. 安装MCP服务器: 最简单的方法是使用MCP客户端的扩展安装功能，例如对于Gemini CLI： 
    gemini extensions install https://github.com/GoogleCloudPlatform/gemini-cloud-assist-mcp

服务器配置

MCP客户端需要配置MCP服务器的启动命令。以下是通用的配置信息，它告诉客户端使用'npx'按需下载并运行最新版本的MCP服务器。您需要将此配置片段添加到您所使用的MCP客户端的设置文件中。

  • 对于 Gemini CLI，可以添加到 '~/.gemini/settings.json' 或项目级 '/.gemini/settings.json'。
  • 对于 Claude Desktop，添加到 'claude_desktop_config.json'。
  • 对于 Claude Code，可以使用命令 'claude mcp add GeminiCloudAssist npx -y https://github.com/GoogleCloudPlatform/gemini-cloud-assist-mcp'。
  • 对于 Cline，更新 'cline_mcp_settings.json'。

配置信息说明 (JSON格式示例中的字段及含义):

  • '"GeminiCloudAssist"': 服务器的逻辑名称，您可以在客户端中使用此名称引用该MCP服务器。
  • '"command"': 'npx'。这是Node Package Execute命令，用于运行远程包。
  • '"args"': '["-y", "https://github.com/GoogleCloudPlatform/gemini-cloud-assist-mcp"]'。这是'npx'命令的参数。'-y' 表示自动确认安装，后面紧跟的GitHub仓库URL指示'npx'从该URL下载并运行MCP服务器。
  • '"timeout"': '600000'。这是服务器启动的超时时间，单位为毫秒。

基本使用方法

配置完成后，您可以通过MCP客户端（例如Gemini CLI）直接使用自然语言与Google Cloud环境进行交互。客户端会自动调用此MCP服务器暴露的工具来执行您的指令。

  • 示例1：调查GKE集群问题 您可以在客户端中输入类似如下的自然语言指令： '> Investigate the pending pods issue in my test-cluster-1 cluster' 系统将自动调用'create_investigation'和'run_investigation'工具来创建并运行调查，然后提供问题分析和修复建议。
  • 示例2：查找和分析Cloud资源 您可以在客户端中输入类似如下的自然语言指令： '> Give me an overview of my GKE node pools. For each one, show me its cluster and MIGs' 系统将调用'search_and_analyze_gcp_resources'工具查询并汇总您GKE节点池的详细信息。

信息

分类

AI与计算

访问项目