Gcp MCP

🚀 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