Gdrive MCP Server

🚀 Google Drive MCP 服務器

這是一個功能強大的模型上下文協議 (MCP) 服務器，它實現了與 Google Drive 的無縫集成，讓 AI 模型能夠在 Google Drive 中進行文件搜索、列表查看以及內容讀取操作。

🚀 快速開始

前置條件

• Node.js（v14 或更高版本）
• npm（5.7 或更高版本）

安裝

npm install gdrive-mcp-server

使用示例

基礎用法

import { GDriveMCP } from 'gdrive-mcp-server';

async function main() {
  const gdrive = new GDriveMCP({
    credentialsPath: './credentials.json',
    tokenPath: './token.json'
  });

  // 搜索文件
  const files = await gdrive.search({ query: 'quarterly report' });
  console.log('搜索結果:', files);

  // 讀取文件內容
  const contents = await gdrive.read('your-file-id');
  console.log('文件內容:', contents);
}

main().catch(console.error);

✨ 主要特性

工具

1. gdrive_search

可在你的 Google Drive 中利用強大的全文搜索功能來搜索文件。

• 輸入：

  {
    "query": "string (你的搜索查詢)"
  }
  

• 輸出：包含以下信息的文件列表：
  • 文件名
  • MIME 類型
  • 文件 ID
  • 最後修改時間
  • 文件大小

2. gdrive_read_file

能使用 Google Drive 文件 ID 直接讀取文件內容。

• 輸入：

  {
    "file_id": "string (Google Drive 文件 ID)"
  }
  

• 輸出：以適當格式轉換的文件內容

自動文件格式處理

服務器可智能處理不同的 Google Workspace 文件類型：

• 📝 Google Docs → Markdown
• 📊 Google Sheets → CSV
• 📊 Google Presentations → 文本
• 🎨 Google Drawings → PNG
• 📄 文本/JSON 文件 → UTF-8 文本
• 📦 其他文件 → Base64 編碼

📦 安裝指南

創建 Credentials 文件

需在 credentials.json 中添加你的 Google Drive 憑據：

{
  "type": "service_account",
  "project_id": "your-project-id",
  "private_key_id": "your-private-key-id",
  "private_key": "your-private-key",
  "client_email": "your-client-email",
  "token_uri": "https://oauth2.googleapis.com/token"
}

認證流程

1. 使用你的 Google 賬戶訪問 Google Cloud Console
2. 創建一個新的項目或選擇現有項目。
3. 啟用 Drive API v3 API。
4. 創建服務賬號並下載 JSON 密鑰文件（即 credentials.json）。

授權

運行你的應用以獲取必要的 OAuth 令牌：

node src/auth.js

📚 詳細文檔

配置

創建 Credentials 文件

在 credentials.json 中添加你的 Google Drive 憑據，具體格式如下：

{
  "type": "service_account",
  "project_id": "your-project-id",
  "private_key_id": "your-private-key-id",
  "private_key": "your-private-key",
  "client_email": "your-client-email",
  "token_uri": "https://oauth2.googleapis.com/token"
}

認證流程

1. 用你的 Google 賬戶訪問 Google Cloud Console。
2. 可選擇創建新項目或使用現有項目。
3. 啟用 Drive API v3 API。
4. 創建服務賬號並下載 JSON 密鑰文件（即 credentials.json）。

授權

運行以下命令來獲取必要的 OAuth 令牌：

node src/auth.js

安全

• 所有敏感憑證都存儲在 credentials 目錄中。
• OAuth 憑證和令牌不在版本控制中。
• 對 Google Drive 採用只讀訪問方式。
• 使用安全的 OAuth 2.0 認證流程。

貢獻

歡迎大家貢獻代碼！你可以隨意提交 Pull Request。

授權協議

此 MCP 服務器遵循 MIT 許可證進行分發。你可以查看 LICENSE 文件以獲取詳細信息。

故障排除

若你遇到問題，可按以下步驟排查：

1. 驗證你的 Google Cloud 項目設置。
2. 確保所有所需的 OAuth 範圍已啟用。
3. 檢查憑證是否正確放置在 credentials 目錄中。
4. 驗證 Google Drive 中的文件權限和訪問權限。

更多資源

• Google Drive API 文檔
• OAuth 2.0 for Desktop Apps
• 模型上下文協議文檔