local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables querying and management of Google Cloud Platform resources including Compute Engine, Cloud Storage, Cloud Functions, Cloud Run, BigQuery, Cloud SQL, GKE, Cloud Logging, Cloud Billing and Resource Manager using natural language.
Provides tools for listing and managing Google Kubernetes Engine (GKE) clusters across different regions.

气相色谱法 (GCP) 气相色谱法

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

特征

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

先决条件

Node.js
Claude 桌面/光标/风帆冲浪
本地配置的 GCP 凭据（应用程序默认凭据）

安装

克隆存储库：

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

安装依赖项：

npm install

配置

克劳德桌面

打开 Claude 桌面应用程序并转到“设置”->“开发者”->“编辑配置”
将以下条目添加到您的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 并转到“设置”(⌘,)
导航至 AI -> 模型上下文协议
添加新的 MCP 配置：

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

风帆冲浪

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

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

GCP 设置

设置 GCP 凭据：
- 使用gcloud auth application-default login设置应用程序默认凭据
刷新你的人工智能助手（Claude Desktop/Cursor/Windsurf）

用法

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

“列出我有权访问的所有 GCP 项目”
“显示项目 X 中的所有 Cloud SQL 实例”
“我目前的账单状态是什么？”
“显示我的 Cloud Run 服务的日志”
“列出 us-central1 中的所有 GKE 集群”
“显示项目 X 中的所有 Cloud Storage 存储桶”
“us-central1 中部署了哪些云功能？”
“列出所有 Cloud Run 服务”
“向我展示 BigQuery 数据集和表格”

可用工具

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

交互示例

列出可用项目：

List all GCP projects I have access to

选择一个项目：

Use project my-project-id

检查账单状态：

What's my current billing status?

查看日志：

Show me the last 10 log entries from my project

支持的服务

Google 计算引擎
云存储
云函数
云运行
BigQuery
云端 SQL
谷歌 Kubernetes 引擎 (GKE)
云日志
云计费
资源管理器
更多内容即将推出...

故障排除

查看日志：

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

常见问题：

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

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

执照

麻省理工学院

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

模型上下文协议服务器使 Claude 等 AI 助手能够通过自然语言与 Google Cloud Platform 环境进行交互，从而允许用户在对话过程中查询和管理 GCP 资源。

Related Resources

Reddit Discussion about this server

GCP MCP