MCP Gdrive

🚀 Google Drive 服務器

本 MCP 服務器與 Google Drive 集成，可實現文件的列出、讀取和搜索，還能對 Google 表格進行讀寫操作，為文件管理和表格處理提供便利。

該項目包含由 Anthropic, PBC 最初開發的代碼，遵循 MIT License 許可，代碼源自 這個倉庫。

✨ 主要特性

• 與 Google Drive 集成，實現文件搜索、讀取及 Google 表格讀寫功能。
• 提供多種工具，滿足不同場景下對 Google Drive 和 Google 表格的操作需求。

📦 安裝指南

1. 創建項目：在 Google Cloud Console 中創建新項目。
2. 啟用 API：啟用 Google Drive API 和其他必要的 API。
3. 創建 OAuth 應用：配置 OAuth 以獲取用戶授權。
4. 設置環境變量：配置 CLIENT_ID、CLIENT_SECRET 和 GDRIVE_CREDENTIALS_DIR 環境變量。
5. 運行命令：使用指定的命令行參數啟動服務器。

💻 使用示例

基礎用法

以下是示例配置，展示如何啟動服務器：

{
  "gdrive": {
    "command": "npx",
    "args": ["-y", "@isaacphi/mcp-gdrive"],
    "env": {
      "CLIENT_ID": "<CLIENT_ID>",
      "CLIENT_SECRET": "<CLIENT_SECRET>",
      "GDRIVE_CREDENTIALS_DIR": "/path/to/config/directory"
    }
  }
}

高級用法

在實際使用中，可根據不同需求調用不同工具，以下為各工具的詳細說明：

工具

• gdrive_search

  • 描述：在 Google Drive 中搜索文件。
  • 輸入：
    • query (字符串)：搜索查詢。
    • pageToken (字符串，可選)：下一頁結果的令牌。
    • pageSize (數字，可選)：每頁的結果數（最多 100）。
  • 輸出：返回匹配文件的名稱和 MIME 類型。

• gdrive_read_file

  • 描述：從 Google Drive 讀取文件內容。
  • 輸入：
    • fileId (字符串)：要讀取的文件 ID。
  • 輸出：返回指定文件的內容。

• gsheets_read

  • 描述：帶有靈活範圍和格式選項地從 Google 表格中讀取數據。
  • 輸入：
    • spreadsheetId (字符串)：要讀取的表格 ID。
    • ranges (字符串數組，可選)：可選的 A1 格式範圍數組（例如 [ 'Sheet1!A1:B10' ]）。如果沒有提供，則讀取整個表格。
    • sheetId (數字，可選)：特定要讀取的工作表 ID。如果沒有提供且未指定範圍，則讀取第一張工作表。
  • 輸出：返回指定的數據。

• gsheets_update_cell

  • 描述：更新 Google 表格中的單元格值。
  • 輸入：
    • fileId (字符串)：表格的 ID。
    • range (字符串)：單元格範圍，A1 格式（例如 'Sheet1!A1'）。
    • value (字符串)：新的單元格值。
  • 輸出：確認指定單元格已更新。

資源

該服務器提供對 Google Drive 文件的訪問：

• 文件 (gdrive:///<file_id>)
  • 支持所有文件類型。
  • 處理不同文件類型的說明，如文本、圖片等。

📄 許可證

此 MCP 服務器根據 MIT License 分發。這意味著您可以自由使用、修改和分發軟件，但需遵守 MIT License 的條款。更多詳細信息，請參閱項目存儲庫中的 LICENSE 文件。

通過以上內容，您將能夠配置並運行一個集成 Google Drive 功能的 MCP 服務器，用於文件管理和表格操作。