🚀 GCP MCP 服务器

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-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 资源。以下是使用示例：

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

可用工具

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

示例互动

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

故障排除

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

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

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

🤝 贡献

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

📄 许可证

MIT