GCP MCP

一个模型上下文协议 (MCP) 服务器，使像 Claude 这样的人工智能助手能够与您的 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 桌面应用程序，转到 Settings -> Developer -> Edit Config

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 并转到 Settings (⌘,)
2. 导航到 AI -> Model Context Protocol
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. 刷新您的人工智能助手 (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

2. 选择一个项目：

Use project my-project-id

3. 检查结算状态：

What's my current billing status?

4. 查看日志：

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