Googlesheet MCP

🚀 Google Sheets MCP 服務器

本 MCP 服務器提供了與 Google 表格進行交互的工具，可實現對電子表格數據的讀取、寫入和更新操作，為數據處理提供便利。

🚀 快速開始

此 MCP 服務器可讓你輕鬆與 Google 表格交互，以下是使用前的準備及操作步驟。

✨ 主要特性

• 提供與 Google 表格交互的工具，支持讀取、寫入和更新電子表格中的數據。

📦 安裝指南

先決條件

• Python 3.8 或更高版本
• Google Cloud Platform 賬戶
• 一個你想交互的 Google 表格

安裝步驟

1. 克隆此倉庫：

git clone <your-repository-url>
cd mcp-server-demo

2. 安裝所需的包：

pip install google-auth-oauthlib google-auth-httplib2 google-api-python-client

3. 下載並放置 credentials.json 文件：
   • 從你的 Google Cloud Console 下載 credentials.json 文件。
   • 將 credentials.json 文件放在與 main.py 同一目錄中。
   • 確保文件名正好是 credentials.json。

配置 Google Cloud Platform 憑據

1. 前往 Google Cloud Console。
2. 創建新項目或選擇現有項目。
3. 啟用 Google Sheets API：
   • 轉到 "APIs & Services" > "Library"。
   • 搜索 "Google Sheets API"。
   • 點擊 "Enable"。
4. 創建憑據：
   • 轉到 "APIs & Services" > "Credentials"。
   • 點擊 "Create Credentials" > "Service Account"。
   • 填寫服務賬戶詳細信息：
     • 名稱：選擇一個描述性名稱。
     • ID：自動生成。
     • 描述：可選描述。
   • 點擊 "Create and Continue"。
   • 對於角色，選擇 "Editor"（或根據需要選擇適當的角色）。
   • 點擊 "Continue" 然後是 "Done"。
5. 創建並下載密鑰：
   • 在服務賬戶列表中，點擊你新創建的賬戶。
   • 轉到 "Keys" 標籤頁。
   • 點擊 "Add Key" > "Create new key"。
   • 選擇 "JSON" 格式。
   • 點擊 "Create"，JSON 文件會自動下載。
6. 保存憑據：
   • 將下載的 JSON 文件重命名為 credentials.json。
   • 放置在 mcp-server-demo 目錄中。
7. 分享你的 Google 表格：
   • 打開你的 Google 表格。
   • 點擊 "Share" 按鈕。
   • 添加服務賬戶電子郵件（在 credentials.json 文件的 client_email 字段中找到）。
   • 給它 "Editor" 訪問權限。

安裝 MCP 服務器

1. 下載 MCP 服務器：

git clone https://github.com/YOUR_REPO/mcp-server.git
cd mcp-server

2. 安裝依賴項：

pip install -r requirements.txt

3. 啟動 MCP 服務器：

python server.py

💻 使用示例

基礎用法

以下是一些常用命令的使用示例：

列出所有命令

mcp list-commands

獲取表格數據

mcp get-table --spreadsheet_id YOUR_SPREADSHEET_ID --sheet_name YOUR_SHEET_NAME

添加新記錄

mcp add-record --spreadsheet_id YOUR_SPREADSHEET_ID --sheet_name YOUR_SHEET_NAME --data "value1,value2\nvalue3,value4"

更新記錄

mcp update-record --spreadsheet_id YOUR_SPREADSHEET_ID --sheet_name YOUR_SHEET_NAME --identifier RECORD_IDENTIFIER --updates "column1=value1\ncolumn2=value2"

📚 詳細文檔

安全注意事項

⚠️ 重要提示

• 憑據管理：從版本控制系統中排除 credentials.json，定期輪換你的憑據，只與必要的服務賬戶共享你的 Google 表格。
• 權限控制：確保服務賬戶電子郵件已作為編輯添加到表格，驗證 credentials.json 文件的有效性和安全性。
• 數據保護：定期備份重要數據，使用 HTTPS 傳輸敏感信息，遵守相關的隱私法規和政策。

故障排除

常見問題

• 身份驗證錯誤：
  • 確保服務賬戶電子郵件已作為編輯添加到表格。
  • 驗證 credentials.json 文件的有效性和完整性。
  • 檢查 Google Sheets API 是否在你的 Google Cloud 項目中啟用。
• 權限錯誤：
  • 確認服務賬戶具有正確的權限。
  • 驗證表格是否已與服務賬戶電子郵件共享。
  • 檢查表格 ID 是否正確。
• 數據格式錯誤：
  • 確保數據格式符合預期結構。
  • 檢查表格是否有所需的列（id 或名稱）。
  • 驗證數據的列數與表格一致。

聯繫方式

如有任何問題或疑問，請按以下步驟操作：

1. 檢查日誌中的錯誤信息。
2. 驗證你的設置是否符合上述說明。
3. 確保所有先決條件已滿足。
4. 聯繫 aryanpandit17032002@gmail.com。