MCP Google Sheets 專案

MCP工具

MCP Google Sheets 專案

mcp-google-sheets 是一個基於 Python 的模型內容協定 (Model Context Protocol, MCP) 伺服器。它的核心功能是作為一座橋樑，連接任何與 MCP 相容的 AI 助理（例如 Claude Desktop）和您的 Google 雲端硬碟 (Google Drive) 與 Google 試算表 (Google Sheets)。

透過這個專案，您可以直接用自然語言命令您的 AI 助理，來執行建立、讀取、修改、分享和管理電子試算表等強大的自動化資料處理任務。

核心價值：賦予 AI 操作電子表格的能力

傳統上，AI 助理難以直接與像 Google Sheets 這樣複雜的雲端應用程式互動。mcp-google-sheets 打破了這一限制，其核心價值在於：

• 自然語言互動: 將複雜的 API 操作封裝成 AI 可以理解和調用的工具，讓使用者可以說出「幫我建立一份名為『第三季銷售報告』的試算表」或「讀取『庫存清單』中 A1 到 C10 的資料」這樣的指令。
• 強大的資料自動化: 使得基於 AI 的資料整理、報告生成、數據批次更新等工作流程成為可能，極大地提升了處理電子表格的效率。
• 無縫整合: 直接與 Google 的官方 API 對接，確保了操作的穩定性和可靠性。

主要功能與工具集

此專案提供了一套非常全面的工具集，幾乎涵蓋了所有常見的 Google Sheets 操作：

• 檔案管理:

  • list_spreadsheets: 列出指定雲端硬碟資料夾中的所有試算表。
  • create_spreadsheet: 建立一份新的試算表。
  • share_spreadsheet: 將試算表分享給指定的使用者並設定權限（讀取、評論、寫入）。

• 資料讀取:

  • get_sheet_data: 從指定的工作表和範圍中讀取儲存格資料。
  • get_sheet_formulas: 專門讀取儲存格中的公式。
  • get_multiple_sheet_data: 一次性從多個不同的試算表中讀取資料。
  • get_multiple_spreadsheet_summary: 快速獲取多個試算表的摘要資訊（標題、工作表名稱、前幾行資料等）。

• 資料寫入與修改:

  • update_cells: 將資料寫入指定範圍（會覆蓋原有資料）。
  • batch_update_cells: 在一次請求中更新多個不同範圍的儲存格。
  • add_rows: 在工作表的末尾追加新的資料列。

• 工作表操作:

  • list_sheets: 列出單一試算表中的所有工作表（分頁）。
  • create_sheet: 在試算表中新增一個工作表。

安裝與驗證

這是使用此專案最關鍵的一步。使用者必須先在 Google Cloud Platform (GCP) 中進行設定，包括啟用 Google Drive API 和 Google Sheets API，並設定身份驗證憑證。

專案提供了極其靈活且詳細的驗證方式說明，以適應不同使用場景：

1. 服務帳號 (Service Account): 官方最推薦的方式，特別適合在伺服器或自動化環境中使用，無需瀏覽器互動，安全性高。
2. OAuth 2.0: 適合個人在本機開發使用，首次執行時會透過瀏覽器進行互動式登入授權。
3. 直接憑證注入 (Base64): 適合在 Docker 或 CI/CD 等不方便管理檔案但易於設定環境變數的環境中使用。
4. 應用程式預設憑證 (ADC): 適用於 Google Cloud 環境（如 GKE、Compute Engine），或在本機透過 gcloud 指令登入的開發者。

簡易的部署方式

此專案最大的亮點之一是其極簡的啟動方式。藉助於 uv 這個快速的 Python 套件管理器，使用者只需在設定好環境變數後，於終端機執行一行指令即可啟動伺服器：

uvx mcp-google-sheets@latest

uvx 會自動下載最新版本的程式碼並執行，提供了近乎「免安裝」的流暢體驗。

總結來說，mcp-google-sheets 是一個功能強大、設定靈活且使用便捷的 MCP 伺服器，它成功地將 AI 的對話能力與 Google Sheets 強大的資料處理能力結合起來，為使用者開啟了全新的自動化工作方式。

• MCP平台來源: github
• 連結: https://github.com/xing5/mcp-google-sheets

立即試用MCP工具