Google Drive And Sheets MCP Server

🚀 Google Drive & Sheets MCP 服務器

本項目是一個用 Rust 編寫的 Model Context Protocol (MCP) 服務器，可實現與 Google Drive 和 Google Sheets 的交互。它為 Google Workspace 服務提供了 MCP 兼容接口，能夠作為更大代理工作流和組合的一部分使用，極大地拓展了 Google Workspace 服務的應用場景。

✨ 主要特性

Google Drive 操作

• 文件列表篩選：可列出 Google Drive 中的文件，並帶有豐富的過濾選項，如按 MIME 類型篩選、自定義搜索查詢、可配置的每頁大小以及自定義排序。

Google Sheets 操作

• 數據讀寫：支持從 Google Sheets 讀取數據，可指定範圍、選擇主要維度（行或列）；也能將數據寫入 Google Sheets。
• 電子表格管理：能創建新電子表格，可自定義標題並設置多個工作表；還可清除電子表格範圍內的值。

📚 詳細文檔

MCP 集成

此服務器實現了 Model Context Protocol (MCP)，與代理框架（如 Distri）兼容。每個服務通過 MCP 工具公開其功能：

Drive 工具

• list_files：可按自定義參數列出和篩選 Drive 文件。
• 可用功能通過 resources/list 端點公開。

Sheets 工具

• read_values：可控制維度讀取電子表格數據。
• write_values：用於將數據寫入電子表格。
• create_spreadsheet：創建新電子表格。
• clear_values：清除範圍內的值。
• 可用功能通過 resources/list 端點公開。

📦 安裝指南

先決條件

• Rust（最新穩定版本）
• 啟用了 Drive 和 Sheets API 的 Google Cloud 項目
• 配置了 Google OAuth 2.0 憑證

安裝步驟

直接從 GitHub 使用 Cargo 安裝 mcp-google 二進制文件：

cargo install --git https://github.com/distrihub/mcp-google-workspace.git

這將把 mcp-google 命令安裝到您的系統。

🔧 配置說明

使用服務器之前，您需要執行以下操作：

1. 設置 Google Cloud 項目。
2. 啟用 Google Drive 和 Google Sheets API。
3. 創建 OAuth 2.0 憑證。
4. 設置環境變量：
   • ACCESS_TOKEN：您的 Google OAuth 訪問令牌。
   • GOOGLE_CLIENT_ID：您的 OAuth 客戶端 ID。
   • GOOGLE_CLIENT_SECRET：您的 OAuth 客戶端密鑰。
   • GOOGLE_REFRESH_TOKEN：您的 OAuth 刷新令牌。

💻 使用示例

作為 MCP 服務器

可以獨立啟動各個服務器，並通過 MCP 協議使用標準輸入輸出進行通信：

啟動 Drive MCP 服務器

mcp-google drive --access-token <your-access-token>

啟動 Sheets MCP 服務器

mcp-google sheets --access-token <your-access-token>