GCP MCP

一种模型上下文协议（MCP）服务器，使像Claude这样的AI助手能够与您的Google Cloud Platform环境进行交互。这允许在对话过程中使用自然语言查询和管理您的GCP资源。

特性

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

前提条件

• Node.js
• Claude Desktop/Cursor/Windsurf
• 本地配置的GCP凭据（应用程序默认凭据）

安装

1. 克隆仓库：

git clone https://github.com/eniayomi/gcp-mcp
cd gcp-mcp

1. 安装依赖项：

npm install

配置

Claude Desktop

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替换为您的项目目录的实际路径。

Cursor

1. 打开Cursor并转到设置 (⌘,)
2. 导航至 AI -> 模型上下文协议
3. 添加新的MCP配置：

{
  "gcp": {
    "command": "npx -y gcp-mcp"
  }
}

Windsurf

1. 打开~/.windsurf/config.json（如果不存在则创建）
2. 添加MCP配置：

{
  "mcpServers": {
    "gcp": {
      "command": "npx -y gcp-mcp"
    }
  }
}

GCP 设置

1. 设置GCP凭据：

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

2. 刷新您的AI助手（Claude Desktop/Cursor/Windsurf）

使用方法

开始时可以选择一个项目或询问类似的问题：

• "列出我有权访问的所有GCP项目"
• "显示项目X中的所有Cloud SQL实例"
• "我的当前账单状态是什么？"
• "显示来自我的Cloud Run服务的日志"
• "列出us-central1中的所有GKE集群"
• "显示项目X中的所有Cloud Storage存储桶"
• "在us-central1部署了哪些Cloud Functions？"
• "列出所有Cloud Run服务"
• "显示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: 获取当前项目的Cloud Logging条目

示例交互

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

支持的服务

• Google Compute Engine
• Cloud Storage
• Cloud Functions
• Cloud Run
• BigQuery
• Cloud SQL
• Google Kubernetes Engine (GKE)
• Cloud Logging
• Cloud Billing
• Resource Manager
• 更多即将推出...

故障排除

要查看日志：

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

常见问题：

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

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

MIT