使用说明
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 |
|
| 存储 | 与Google Cloud storage交互以进行存储桶和对象管理。 | storage-mcp |
🚀 入门指南
先决条件
- Node.js: 版本20或更高
- gcloud命令行界面
✨ 设置您的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 |
列出项目的错误组。 | |
| 存储器 | list_objects |
列出GCS存储桶中的对象。 |
read_object_metadata |
读取特定对象的全面元数据。 | |
read_object_content |
读取特定对象的内容。 | |
delete_object |
从bucket中删除特定对象。 | |
write_object |
将新对象写入bucket。 | |
update_object_metadata |
更新现有对象的自定义元数据。 | |
copy_object |
将对象从一个桶复制到另一个桶。 | |
move_object |
将对象从一个桶移动到另一个桶。 | |
upload_object |
将文件上传到GCS存储桶。 | |
download_object |
将对象从GCS下载到本地文件。 | |
list_buckets |
列出项目中的所有bucket。 | |
create_bucket |
创建一个新的bucket。 | |
delete_bucket |
删除一个bucket。 | |
get_bucket_metadata |
获取特定存储桶的全面元数据。 | |
update_bucket_labels |
更新桶的标签。 | |
get_bucket_location |
获取存储桶的位置。 | |
view_iam_policy |
查看bucket的IAM策略。 | |
check_iam_permissions |
测试bucket的IAM权限。 | |
get_metadata_table_schema |
检查GCS洞察服务是否已启用，并返回给定洞察数据集配置的BigQuery表模式。 | |
execute_insights_query |
对洞察数据集执行BigQuery SQL查询并返回结果。 | |
list_insights_configs |
列出给定项目的所有Storage Insights数据集配置的名称。 |
🔑 MCP权限
gcloud MCP的权限直接与活动程序的权限相关联 gcloud帐户。限制权限，以最小原则操作 特权，你可以 使用模拟作为服务帐户进行授权 和 为服务帐户分配a 权限有限的角色.
默认情况下，gcloud MCP会阻止执行不符合以下条件的gcloud命令 对AI代理来说是有意义的。这样做是为了限制可以运行的命令 任意输入并启动交互式会话。看 这里 查看被拒绝的命令列表。
💫 其他Google Cloud MCP服务器
Google Cloud提供以下其他服务器：
👥 贡献
我们欢迎捐款！无论你是在修复bug、分享反馈，还是 改进文档，欢迎您的贡献。请阅读我们的 贡献指南 开始吧。
📄 重要提示
此存储库当前处于预览状态，可能会看到重大更改。这 存储库提供了一种解决方案，而不是官方支持的谷歌产品。它 不包括在 Google Cloud服务条款. 当MCP规范、其他SDK或其他解决方案出现故障时，它可能会中断 产品也在变化。另请参阅我们的 安全策略.
