MCP Google Sheets

🚀 如何將Google Sheets與Claude集成：完整指南

本指南將詳細介紹如何將Google Sheets與Claude集成，幫助你實現數據的高效管理和處理。

🚀 快速開始

準備工作

在開始之前，請確保安裝了以下工具：

• Python 3.6或更高版本
• pip
• 谷歌瀏覽器或其他現代瀏覽器

✨ 主要特性

• 支持多種身份驗證方式，包括服務賬戶、OAuth 2.0和Base64編碼的CREDENTIALS_CONFIG。
• 提供詳細的代碼示例，涵蓋讀取電子表格內容、創建新工作表等操作。
• 可在Claude中輕鬆集成，實現數據的交互和處理。

📦 安裝指南

第一步：配置身份驗證

方法一：使用服務賬戶（推薦）

1. 創建服務賬戶
   • 登錄Google Cloud Console。
   • 進入項目設置 > 人員 > 添加成員。
   • 選擇“服務賬戶”並賦予所需權限（如“Compute Engine Admin”或“Storage Admin”）。
2. 下載JSON密鑰文件
   • 完成後，點擊項目名稱進入項目概覽頁面。
   • 在左側菜單中選擇“APIs & Services” > “Credentials”。
   • 點擊“Create Credentials”並選擇“Service account key”。
   • 下載生成的JSON文件（通常命名為service-account-key.json）。
3. 設置環境變量

export SERVICE_ACCOUNT_PATH="/path/to/service-account-key.json"
export DRIVE_FOLDER_ID="your-shared-folder-id"

方法二：使用OAuth 2.0

1. 創建OAuth 2.0客戶端ID
   • 在Google Cloud Console中，導航至“APIs & Services” > “Credentials”。
   • 點擊“Create Credentials”並選擇“OAuth client ID”。
   • 配置重定向URI（如http://localhost:8000/callback）。
2. 獲取用戶同意
   • 運行腳本後，瀏覽器將自動打開授權頁面。
   • 用戶需要登錄Google賬戶並允許權限。
3. 設置環境變量

export CREDENTIALS_PATH="/path/to/credentials.json"
export TOKEN_PATH="/path/to/token.json"

方法三：使用CREDENTIALS_CONFIG（Base64編碼）

1. 將JSON密鑰文件轉換為Base64字符串
   • 使用工具如base64命令或在線轉換器。
   • 示例：

echo '{"type":"service_account","project_id":"your-project-id","private_key_id":"key-id","private_key":"your-private-key","client_email":"service-account@your-project.iam.gserviceaccount.com","token_uri":"https://accounts.google.com/o/oauth2/token","auth_provider_x509_cert_url":"https://www.googleapis.com/robot/v1/metadata/x509/certs"}' | base64 -w 0 > credentials_base64.txt

2. 設置環境變量

export CREDENTIALS_CONFIG="Base64-encoded-string"
export DRIVE_FOLDER_ID="your-shared-folder-id"

第二步：安裝依賴

pip install google-api-python-client fastmcp

💻 使用示例

基礎用法

示例：讀取電子表格內容

from fastmcp import FastMCP
from googleapiclient.discovery import build

# 初始化FastMCP客戶端
client = FastMCP(
    auth_method="service_account",
    service_account_key_path="/path/to/service-account-key.json"
)

# 創建Sheets API服務
sheets_service = build('sheets', 'v4', credentials=client.credentials)

# 獲取電子表格數據
spreadsheet_id = "your-spreadsheet-id"
result = sheets_service.spreadsheets().values().get(
    spreadsheetId=spreadsheet_id,
    range="A1:B2"
).execute()

print(result)

示例：創建新的工作表

from fastmcp import FastMCP
from googleapiclient.discovery import build

# 初始化FastMCP客戶端
client = FastMCP(
    auth_method="service_account",
    service_account_key_path="/path/to/service-account-key.json"
)

# 創建Sheets API服務
sheets_service = build('sheets', 'v4', credentials=client.credentials)

# 新建工作表請求體
new_sheet_request = {
    "addSheet": {
        "properties": {
            "title": "New Sheet",
            "sheetType": "GRID"
        }
    }
}

# 執行API調用
result = sheets_service.spreadsheets().batchUpdate(
    spreadsheetId="your-spreadsheet-id",
    body={"requests": [new_sheet_request]}
).execute()

print("新工作表已創建")

高級用法

第三步：在Claude中集成

示例配置

{
  "configurations": {
    "google_sheets": {
      "auth_method": "service_account",
      "service_account_key_path": "/path/to/service-account-key.json",
      "spreadsheet_id": "your-spreadsheet-id",
      "drive_folder_id": "your-shared-folder-id"
    }
  },
  "enabled_providers": ["google_sheets"]
}

第四步：使用說明

1. 啟動服務

python your_script.py

2. 發送請求 示例：

{
  "provider": "google_sheets",
  "operation": "read_range",
  "params": {
    "spreadsheet_id": "your-spreadsheet-id",
    "range": "A1:A10"
  }
}

3. 處理響應 服務將返回JSON格式的結果：

{
  "status": "success",
  "data": {
    "values": [
      ["Header"],
      ["Row 1 Data"],
      ...
    ]
  }
}

📚 詳細文檔

額外注意事項

• 錯誤處理：確保在代碼中添加適當的異常處理，以捕獲並重試可能的API調用錯誤。
• 日誌記錄：建議啟用日誌記錄功能，以便於調試和監控服務狀態。
• 安全提示：
  • 避免直接將密鑰文件提交到版本控制系統。
  • 定期更新服務賬戶密鑰。
  • 在生產環境中使用環境變量管理敏感信息。

通過以上步驟，您可以成功地將Google Sheets與Claude集成，並根據需要進行擴展和定製。