Gcloud Go MCP

GCloud MCP服务器

封装Google Cloud CLI的模型上下文协议（MCP）服务器(gcloud)提供LLM可访问的工具来管理GCP资源。

特性

• 67+工具 涵盖12项GCP服务
• 包装本地 gcloud CLI命令
• 结构化数据的JSON输出
• 项目、地区和区域的可配置默认值

支持服务列表

先决条件

1. 谷歌云SDK -从以下位置安装https://cloud.google.com/sdk/docs/install
2. 认证 -快跑 gcloud auth login 验证
3. 项目 -设置默认项目： gcloud config set project YOUR_PROJECT_ID

安装

来源

git clone https://github.com/khalideidoo/gcloud-go-mcp.git
cd gcloud-go-mcp
make build

安装到PATH

make install

配置

环境变量

Claude桌面配置

添加到您的Claude Desktop配置文件中：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json
• 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "gcloud": {
      "command": "/path/to/gcloud-go-mcp",
      "env": {
        "GCLOUD_PROJECT": "your-default-gcp-project-id",
        "GCLOUD_REGION": "your-default-gcp-region",
        "GCLOUD_ZONE": "your-default-gcp-zone",
        "GCLOUD_PATH": "your-gcloud-cli-path",
        "GCLOUD_TIMEOUT": "gcloud-cli-timeout"
      }
    }
  }
}

工具参考

工具命名约定

所有工具都遵循以下模式： gcp_{service}_{resource}_{action}

示例：

• gcp_run_services_list -列出云运行服务
• gcp_run_services_deploy -部署到云端运行
• gcp_secrets_versions_access -访问秘密版本
• gcp_compute_instances_create -创建VM实例

云运行工具

秘密管理器工具

IAM工具

云存储工具

计算引擎工具

项目工具

使用示例

列出云运行服务

"List my Cloud Run services in us-central1"

部署到云端运行

"Deploy the image gcr.io/my-project/my-app:latest to a Cloud Run service named my-service"

获取秘密

"Get the value of the secret named api-key"

创建VM实例

"Create a VM instance named test-vm in zone us-central1-a with machine type e2-small"

读取日志

"Show me the last 20 error logs from Cloud Run"

发展

构建

make build

运行测试

make test

棉绒

make lint

许可证

MIT许可证