Felores Gdrive MCP Server

🚀 Google Drive MCP 服務器

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

🚀 快速開始

前提條件

• Node.js（v16 或更高版本）
• npm 或 yarn
• 一個 Google Cloud 項目
• Google Workspace 或個人 Google 賬戶

詳細的 Google Cloud 設置

1. 創建 Google Cloud 項目
   • 訪問Google Cloud 控制檯。
   • 點擊“新建項目”。
   • 輸入項目名稱（例如，“MCP GDrive Server”）。
   • 點擊“創建”。
   • 等待項目創建完成並選擇它。
2. 啟用 Google Drive API
   • 前往API 庫。
   • 搜索“Google Drive API”，點擊“啟用”。
3. 設置 OAuth 2.0 客戶端 ID
   • 進入Credentials 部分。
   • 點擊“添加 Credentials”並選擇“OAuth 2.0 客戶端 ID”。
   • 配置項目詳細信息，指定重定向 URI（例如，urn:ietf:wg:oauth:2.0:oob）。
   • 獲取生成的 JSON 密鑰文件，並命名為gcp - oauth.json。
4. 安裝依賴
   • 在項目根目錄下運行：

npm install @google/drive --save

✨ 主要特性

工具

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 編碼

📦 安裝指南

克隆倉庫並安裝依賴：

git clone https://github.com/your - repository/mcp - gdrive.git
cd mcp - gdrive
npm install

💻 使用示例

基礎用法

搜索文件示例

const { searchFiles } = require('./src/drive');

async function main() {
    const query = "quarterly report";
    const result = await searchFiles(query);
    console.log(result.files);
}

main().catch(console.error);

讀取文件內容示例

const { readFile } = require('./src/drive');

async function main() {
    const fileId = "your-file-id";
    const contents = await readFile(fileId);
    console.log(contents);
}

main().catch(console.error);

📚 詳細文檔

🔑 認證

按照以下步驟配置和運行認證：

1. 創建config.json文件，添加你的 Google Cloud 項目 ID 和密鑰路徑：

{
    "projectId": "your-project-id",
    "keyFile": "path/to/gcp-oauth.json"
}

2. 在終端中運行以下命令進行認證：

npm run authenticate

這將引導你完成 OAuth 2.0 流程，獲取必要的訪問令牌。

🔍 故障排除

遇到問題時：

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

📚 額外資源

• Google Drive API 文檔
• OAuth 2.0 桌面應用
• 模型上下文協議文檔

📄 許可證

本 MCP 服務器根據 MIT License 授權。查看LICENSE文件以獲取詳細信息。