AI导哈

GCP资源管理协议

GCP MCP是一个模型上下文协议服务器，允许AI助手通过自然语言查询和管理Google云平台资源。

  • by eniayomi
  • TypeScript
  • 本地部署
  • 199 星标
  • 更新于
在 GitHub 查看 eniayomi/gcp-mcp

使用说明

GCP-MCP

一个模型上下文协议（MCP）服务器，使像克劳德这样的人工智能助手能够与您的谷歌云平台环境进行交互。这允许在对话期间对GCP资源进行自然语言查询和管理。

特性

  • 🔍 使用自然语言查询和修改GCP资源
  • ☁️ 支持多个GCP项目
  • 🌐 多区域支持
  • 🔐 安全的凭据处理（没有凭据暴露给外部服务）
  • 🏃‍♂️ 使用您的GCP凭据进行本地执行
  • 🔄 自动重试以提高可靠性

先决条件

  • Node.js
  • 克劳德桌面/光标/风帆
  • 本地配置的GCP凭据（应用程序默认凭据）

安装

  1. 克隆存储库：
git clone https://github.com/eniayomi/gcp-mcp
cd gcp-mcp
  1. 安装依赖项：
npm install

配置

克劳德桌面

  1. 打开Claude桌面应用程序，进入“设置”->“开发人员”->“编辑配置”

  2. 将以下条目添加到您的 claude_desktop_config.json:

通过npm：

{
  "mcpServers": {
    "gcp": {
      "command": "sh",
      "args": ["-c", "npx -y gcp-mcp"]
    }
  }
}

如果从源代码安装：

{
  "mcpServers": {
    "gcp": {
      "command": "npm",
      "args": [
        "--silent",
        "--prefix",
        "/path/to/gcp-mcp",
        "start"
      ]
    }
  }
}

替换 /path/to/gcp-mcp 如果使用源代码安装，请提供项目目录的实际路径。

光标

  1. 打开光标并转到设置（⌘，）
  2. 导航到AI->模型上下文协议
  3. 添加新的MCP配置：
{
  "gcp": {
    "command": "npx -y gcp-mcp"
  }
}

帆板运动

  1. 打开 ~/.windsurf/config.json （如果不存在则创建）
  2. 添加MCP配置：
{
  "mcpServers": {
    "gcp": {
      "command": "npx -y gcp-mcp"
    }
  }
}

GCP设置

  1. 设置GCP凭据：

    • 使用设置应用程序默认凭据 gcloud auth application-default login

  2. 刷新您的AI助手（克劳德桌面/光标/风帆）

用法

首先，选择一个项目或提出以下问题：

  • “列出我有权访问的所有GCP项目”
  • “显示项目X中的所有Cloud SQL实例”
  • “我目前的账单状态如何？”
  • “显示我的Cloud Run服务的日志”
  • “在us-central中列出所有GKE集群1”
  • “显示项目X中的所有云存储桶”
  • “us-central1中部署了哪些云功能？”
  • “列出所有云运行服务”
  • “显示BigQuery数据集和表”

可用工具

  1. run-gcp-code：使用TypeScript代码执行GCP API调用
  2. list-projects：列出所有可访问的GCP项目
  3. select-project：选择一个GCP项目进行后续操作
  4. get-billing-info：获取当前项目的账单信息
  5. get-cost-forecast：获取当前项目的成本预测
  6. get-billing-budget：获取当前项目的计费预算
  7. list-gke-clusters：列出当前项目中的所有GKE集群
  8. list-sql-instances：列出当前项目中的所有Cloud SQL实例
  9. get-logs：获取当前项目的云日志条目

交互示例

  1. 列出可用项目：
List all GCP projects I have access to
  1. 选择一个项目：
Use project my-project-id
  1. 检查账单状态：
What's my current billing status?
  1. 查看日志：
Show me the last 10 log entries from my project

支持服务列表

  • 谷歌计算引擎
  • 云存储
  • 云功能
  • 云运行
  • BigQuery 的
  • 云SQL
  • 谷歌Kubernetes引擎（GKE）
  • 云日志
  • 云计费
  • 资源管理器
  • 更多即将到来。..

故障排除

要查看日志，请执行以下操作：

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-gcp.log

常见问题：

  1. 身份验证错误：确保您已运行 gcloud auth application-default login
  2. 权限错误：检查您帐户的IAM角色
  3. API错误：验证项目中是否启用了所需的API

贡献

欢迎投稿！请随时提交拉取请求。

许可证

麻省理工学院

相关 MCP