Google Cloud MCP

🚀 Google Cloud MCP 服務器

Google Cloud MCP 服務器是一個基於模型上下文協議（Model Context Protocol）的服務器，它能連接到 Google Cloud 服務，為您提供上下文和工具，方便您與 Google Cloud 資源進行交互。

🚀 快速開始

安裝

# 克隆倉庫
git clone https://github.com/krzko/google-cloud-mcp.git
cd google-cloud-mcp

# 安裝依賴項
pnpm install

# 構建
pnpm build

與 Google Cloud 認證

gcloud auth application-default login

在客戶端中配置 mcpServers

{
  "mcpServers": {
      "google-cloud-mcp": {
          "command": "node",
          "args": [
              "/Users/foo/code/google-cloud-mcp/dist/index.js"
          ],
          "env": {
              "GOOGLE_APPLICATION_CREDENTIALS": "/Users/foo/.config/gcloud/application_default_credentials.json"
          }
      }
  }
}

✨ 主要特性

支持的服務

已支持的服務

• [x] Google Cloud Logging
• [x] Google Cloud Monitoring
• [x] Google Cloud Spanner

正在開發中的服務

• [ ] Google Cloud Trace
• [ ] Google IAM
• [ ] Google Cloud Compute
• [ ] Google Cloud Run
• [ ] Google Cloud Storage

各服務具體功能

Google Cloud Logging

可對來自 Google Cloud Logging 的日誌條目進行查詢和過濾：

• 使用自定義過濾器查詢日誌
• 在特定時間範圍內搜索日誌
• 以易讀的格式顯示日誌條目

Google Cloud Spanner

能與 Google Cloud Spanner 數據庫進行交互：

• 對 Spanner 數據庫執行 SQL 查詢
• 列出可用的數據庫和表
• 探索數據庫模式

Google Cloud Monitoring

可檢索並分析來自 Google Cloud Monitoring 的度量數據：

• 使用自定義過濾器查詢度量
• 隨時間可視化度量數據
• 列出可用的度量類型

Google Cloud Trace

可分析來自 Google Cloud Trace 的分佈式跟蹤：

• 通過 ID 獲取跟蹤
• 列出帶有篩選選項的最近跟蹤
• 查找與日誌關聯的跟蹤
• 確定失敗的跟蹤
• 使用自然語言查詢跟蹤（例如，“顯示過去一小時中的失敗跟蹤”）

🔧 認證

此服務器支持兩種與 Google Cloud 進行認證的方法：

1. 服務賬戶密鑰文件（推薦）：將 GOOGLE_APPLICATION_CREDENTIALS 環境變量設置為您的服務賬戶密鑰文件的路徑。這是 Google Cloud 的標準認證方法。
2. 環境變量：直接設置 GOOGLE_CLIENT_EMAIL 和 GOOGLE_PRIVATE_KEY 環境變量。這對於在無法存儲密鑰文件的環境中很有用。

服務器還將使用 GOOGLE_CLOUD_PROJECT 環境變量（如果已設置），否則將嘗試從認證憑證中確定項目 ID。

💻 使用示例

開發

啟動服務器

# 構建項目
pnpm build

# 啟動服務器
pnpm start

開發模式

# 構建項目
pnpm build

# 啟動服務器和檢查工具
npx -y @modelcontextprotocol/inspector node dist/index.js

與 Smithery 使用（即將推出）

此服務器可以與 Smithery 部署並使用。服務器實現了認證的惰性加載，這意味著它會立即啟動並將認證推遲到實際需要時。認證仍然需要進行操作，但惰性加載允許服務器在初始化期間不會超時。

⚠️ 重要提示

Smithery 本地服務器支持目前仍在開發中，可能尚未可用。

🛠️ 故障排除

服務器超時問題

如果您在使用 Smithery 運行服務器時遇到超時問題，請嘗試以下步驟：

1. 啟用調試日誌記錄，設置 debug: true 在您的配置中
2. 確保 lazyAuth: true 設置以推遲認證直到實際需要
3. 確保您的憑證文件可訪問且格式正確
4. 檢查日誌中的任何錯誤消息

⚠️ 重要提示

認證仍然是操作所需的，但啟用惰性加載後，服務器會立即啟動並在需要時進行認證，而不是在初始化期間。

認證問題

該服務器支持兩種認證方法：

1. 服務賬戶密鑰文件：將 GOOGLE_APPLICATION_CREDENTIALS 環境變量設置為您的服務賬戶密鑰文件的路徑
2. 環境變量：將 GOOGLE_CLIENT_EMAIL 和 GOOGLE_PRIVATE_KEY 環境變量正確設置

如果遇到認證問題，請確保：

• 您的服務賬戶具有必要的權限
• 密鑰文件格式正確且可訪問
• 環境變量已正確設置