 
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 | ](https://www.npmjs.com/package/@google-cloud/gcloud-mcp) |
| 可观测性 | 访问Google Cloud可观测性API以查询日志、指标和跟踪。 | observability-mcp | ](https://www.npmjs.com/package/@google-cloud/observability-mcp) |
🚀 入门指南
先决条件
- :
版本20或更高
✨ 设置您的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或其他解决方案出现故障时，它可能会中断 产品也在变化。另请参阅我们的 安全策略.