AI导哈

自然语言交互式云管理工具

gcloud MCP服务器使AI助手能够通过自然语言与Google Cloud环境交互，简化复杂工作流程并降低云管理门槛。

  • by Gopal-sharma20
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Gopal-sharma20/gcp_mcp_client

使用说明

gcloud MCP服务器☁️

gcloud 模型上下文协议（MCP） 服务器使人工智能助手能够轻松地与谷歌云交互 使用gcloud CLI的环境。使用gcloud MCP服务器，您可以：

  • 使用自然语言与Google Cloud交互。 描述结果 你想要的不是记住复杂的命令语法、标志和参数。
  • 自动化和简化复杂的工作流程。 连锁多个云操作 将命令转换为单个可重复的命令，以减少手动操作和 错误。
  • 降低云管理的准入门槛。 赋予团队成员以下权力 对gcloud不太熟悉，无法自信地执行强大的操作 安全。

📡 可用的MCP服务器

除了gcloud MCP之外，此存储库还托管其他MCP服务器 服务器。下面是最新列表，以及其他Google Cloud MCP的链接 此仓库之外托管的服务器是 这里.

MCP服务器名称 描述 包名称 版本
gcloud 使用自然语言提示通过gcloud CLI与Google Cloud交互。 gcloud-mcp
可观测性 访问Google Cloud可观测性API以查询日志、指标和跟踪。 observability-mcp

🚀 入门指南

先决条件

✨ 设置您的MCP服务器

Gemini CLI和Gemini代码辅助

要将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服务器与其他客户端一起使用，请添加以下代码段 每个MCP服务器的JSON配置文件：

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

例如，对于gcloud：

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

常用工具说明：

  • 克劳德桌面： 打开 Claude>设置>开发人员>编辑配置 和 编辑 claude_desktop_config.json.
  • 克莱恩： 单击MCP服务器图标，然后 配置MCP服务器 编辑 cline_mcp_settings.json.
  • 光标： 编辑 .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和可观测性：

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

🛠 地方发展

有关在本地安装存储库的更多信息，请参阅 发展.md

🧰 可用的MCP工具

MCP服务器 工具 说明
gcloud run_gcloud_command 执行gcloud命令。某些命令已被代理限制执行。看 MCP权限 了解更多信息。
可观测性 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 在项目中按id获取特定跟踪。
list_group_stats 列出项目的错误组。

🔑 MCP权限

gcloud MCP的权限直接与活动程序的权限相关联 gcloud帐户。限制权限，以最小原则操作 特权，你可以 使用模拟作为服务帐户进行授权 和 为服务帐户分配a 权限有限的角色.

默认情况下，gcloud MCP会阻止执行不符合以下条件的gcloud命令 对AI代理来说是有意义的。这样做是为了限制可以运行的命令 任意输入并启动交互式会话。看 这里 查看被拒绝的命令列表。

💫 其他Google Cloud MCP服务器

Google Cloud提供以下其他服务器：

👥 贡献

我们欢迎捐款！无论你是在修复bug、分享反馈，还是 改进文档，欢迎您的贡献。请阅读我们的 贡献指南 开始吧。

📄 重要提示

此存储库当前处于预览状态，可能会看到重大更改。这 存储库提供了一种解决方案，而不是官方支持的谷歌产品。它 不包括在 Google Cloud服务条款. 当MCP规范、其他SDK或其他解决方案出现故障时，它可能会中断 产品也在变化。另请参阅我们的 安全策略.

相关 MCP