JinDaGe - gcp-mcp MCP Details

article

README

🚀 GCP MCP 服务器

GCP MCP 服务器是一个模型上下文协议（MCP）服务器，它能让像 Claude 这样的 AI 助手与您的 Google Cloud Platform 环境进行交互。借助该服务器，您可以在对话过程中通过自然语言查询和管理 GCP 资源。

GCP MCP 演示

✨ 主要特性

🔍 支持使用自然语言查询和修改 GCP 资源。
☁️ 可支持多个 GCP 项目。
🌐 具备多区域支持能力。
🔐 采用安全的凭证处理方式，不会将凭证暴露给外部服务。
🏃♂️ 可在本地执行，使用您本地配置的 GCP 凭证。
🔄 具备自动重试机制，以提高系统的可靠性。

📦 安装指南

先决条件

Node.js
Claude Desktop/Cursor/Windsurf
本地配置好的 GCP 凭证（应用默认凭证）

安装步骤

克隆仓库：

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

安装依赖项：

npm install

📚 详细文档

配置

Claude Desktop

打开 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

打开 Cursor，转到设置 (⌘,)。
导航至 AI -> 模型上下文协议。
添加一个新的 MCP 配置：

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

Windsurf

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

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

GCP 设置

配置 GCP 凭证：
- 使用 gcloud auth application-default login 设置应用默认凭证。
刷新您的 AI 助手（Claude Desktop/Cursor/Windsurf）。

使用说明

该服务器允许通过自然语言查询和管理 GCP 资源。以下是使用示例：

查询所有可用项目：列出我所有的 GCP 项目
获取当前项目的 ID：告诉我当前项目的 ID

可用工具

gcp-mcp-server：用于启动 MCP 服务器。
gcp-mcp-client：用于与 MCP 服务器交互的客户端工具。

示例互动

用户: 列出我所有的 GCP 项目
系统: 好的，以下是您拥有的所有 GCP 项目的列表：
       1. project-12345
       2. dev-environment
       3. production-server

故障排除

如果遇到问题，请检查以下事项：

确保已启用所需的 GCP API。
验证您的账户是否有足够的权限访问资源。
检查日志文件以获取更多错误信息：

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

🤝 贡献

欢迎贡献！请随意提交拉取请求。

📄 许可证

MIT

gcp-mcp