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

2. 安装依赖项：

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-mmcp替换为您项目的实际路径，如果您是从源码安装的。

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. 列出可用项目：

列出我有权访问的所有GCP项目

2. 选择一个项目：

使用项目my-project-id

3. 检查计费状态：

我的当前计费状态是什么？

4. 查看日志：

显示我项目中的最后10个日志条目

支持的服务

• Google Compute Engine
• Cloud Storage
• Cloud Functions
• Cloud Run
• BigQuery
• Cloud SQL
• Google Kubernetes Engine (GKE)
• Cloud Logging
• Cloud Billing
• 资源管理器
• 更多即将推出...

故障排除

查看日志：

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