Google Sheet MCP Server

🚀 Google Sheets MCP 服務器

這是一個強大的基於模型上下文協議（MCP）的服務器實現，專為與 Google Sheets API 實現無縫集成而設計。藉助該服務器，AI 助手能夠輕鬆創建、讀取、更新和管理 Google 表格，為表格操作帶來極大便利。

✨ 主要特性

• 支持創建、讀取、更新和刪除 Google 表格，實現全生命週期管理。
• 可使用單元格級別操作管理表格數據，操作靈活精準。
• 能夠格式化單元格和範圍，讓表格呈現更美觀。
• 支持與其他用戶共享電子表格，方便團隊協作。
• 具備搜索電子表格功能，快速定位所需表格。
• 提供全面的認證選項，滿足不同場景需求。

📦 安裝指南

先決條件

• Node.js（v16 或更高版本）
• 已啟用 Google Sheets API 的 Google Cloud 項目
• Google Cloud 身份驗證憑據（見下文）

安裝步驟

1. 克隆倉庫：

   git clone https://github.com/yourusername/google-sheets-mcp-server.git
   cd google-sheets-mcp-server
   

2. 安裝依賴項：

   npm install
   

3. 設置身份驗證：
   • 基於 .env.example 模板創建一個 .env 文件。
   • 將 Google Cloud 憑據添加到其中。
4. 構建項目：

   npm run build
   

5. 啟動服務器：

   npm start
   

OAuth 設置

對於需要用戶同意的操作（如創建/編輯表格），您需要 OAuth 憑證：

1. 在 Google Cloud 控制檯中創建 OAuth 憑證。
2. 更新 src/get-refresh-token.js 中的 CLIENT_ID 和 CLIENT_SECRET。
3. 安裝所需的依賴項：

   npm install open server-destroy
   

4. 運行腳本來獲取刷新令牌：

   node src/get-refresh-token.js
   

5. 跟隨瀏覽器提示進行授權。
6. 將刷新令牌複製到 .env 文件中。

🔧 技術細節

認證選項

此 MCP 服務器支持多種認證方法：

1. 服務賬戶認證（生產推薦）
   • 提供指向服務賬戶密鑰文件的路徑。
   • 或直接提供服務賬戶 JSON 內容。
2. API Key 認證（開發更簡單）
   • 提供 Google API 密鑰。
3. OAuth2 認證（用於特定用戶操作）
   • 提供 OAuth 客戶端 ID、客戶端密鑰和刷新令牌。

💻 使用示例

基礎用法

服務器提供以下工具：

• google_sheets_create：創建新的 Google 表格
• google_sheets_get：通過 ID 獲取 Google 表格
• google_sheets_update_values：更新 Google 表格中的值
• google_sheets_append_values：向 Google 表格追加值
• google_sheets_get_values：從 Google 表格獲取值
• google_sheets_clear_values：清除 Google 表格中的值
• google_sheets_add_sheet：在現有表格中添加新工作表
• google_sheets_delete_sheet：刪除表格中的工作表
• google_sheets_list：列出對已認證用戶可用的 Google 表格
• google_sheets_delete：刪除 Google 表格
• google_sheets_share：與特定用戶共享 Google 表格
• google_sheets_search：按標題搜索 Google 表格
• google_sheets_format_cells：格式化 Google 表格中的單元格
• google_sheets_verify_connection：驗證與 Google 表格 API 的連接

高級用法

以下是使用此 MCP 服務器與 Claude 一起工作的示例：

現在您可以使用 Google 表格！嘗試以下命令：

1. 創建新的電子表格：
   "創建一個標題為 '月度預算' 的新 Google 表格"

2. 向電子表格添加數據：
   "向我的月度預算電子表格中添加支出類別和金額"

3. 格式化電子表格：
   "將標題行設置為粗體並居中"

4. 共享電子表格：
   "將我的月度預算電子表格與 john@example.com 分享"

📄 許可證

本項目採用 MIT 許可證。