MCP Gdrive Server

🚀 Google Drive 服務器

此 MCP 服務器與 Google Drive 集成，可實現文件的列出、讀取和搜索功能，為用戶提供便捷的文件管理體驗。

🚀 快速開始

項目初始化

1. 創建一個新的 Google Cloud 項目
2. 啟用 Google Drive API
3. 配置 OAuth 同意屏幕（測試時“內部”即可）
4. 添加 OAuth 作用域 https://www.googleapis.com/auth/drive.readonly
5. 為應用類型“桌面應用”創建 OAuth 客戶端 ID
6. 下載客戶端的 OAuth 密鑰文件 JSON 文件
7. 將密鑰文件重命名為 gcp-oauth.keys.json，並將其放置在當前倉庫根目錄中（例如 servers/gcp-oauth.keys.json）

確保使用 npm run build 或 npm run watch 進行構建。

認證流程

要進行認證並保存憑證：

1. 使用 auth 參數運行服務器：node ./dist auth
2. 瀏覽器系統會話中打開身份驗證流程
3. 完成身份驗證過程
4. 憑證將保存在當前倉庫根目錄中（例如 servers/.gdrive-server-credentials.json）

與桌面應用集成

要在桌面應用中使用此服務器，將其添加到應用的服務器配置中：

Docker

身份驗證：

假設您已完成 Google Cloud 上 OAuth 應用的設置，現在可以使用以下命令對服務器進行身份驗證，將 /path/to/gcp-oauth.keys.json 替換為密鑰文件的實際路徑：

docker run -i --rm --mount type=bind,source=/path/to/gcp-oauth.keys.json,target=/gcp-oauth.keys.json -v mcp-gdrive:/gdrive-server -e GDRIVE_OAUTH_PATH=/gcp-oauth.keys.json -e "GDRIVE_CREDENTIALS_PATH=/gdrive-server/credentials.json" -p 3000:3000 mcp/gdrive auth

命令將輸出要在瀏覽器中打開的 URL。在瀏覽器中完成身份驗證流程。憑證將保存在 mcp-gdrive 卷中。

一旦身份驗證成功，可以在應用的服務器配置中使用以下內容：

{
  "mcpServers": {
    "gdrive": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-v", "mcp-gdrive:/gdrive-server", "-e", "GDRIVE_CREDENTIALS_PATH=/gdrive-server/credentials.json", "mcp/gdrive"]
    }
  }
}

npm

要使用 npm 運行服務器：

npm start

直接運行

可以直接運行 JavaScript 文件：

node dist/index.js

✨ 主要特性

工具

• search
  • 搜索 Google Drive 中的文件
  • 輸入：query（字符串）：搜索查詢
  • 返回匹配文件的名稱和 MIME 類型

資源

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

• Files（gdrive:///<file_id>）
  • 支持所有文件類型
  • 自動導出 Google Workspace 文件：
    • 文檔 → Markdown
    • 表格 → CSV
    • 演示文稿 → 純文本
    • 繪圖 → PNG
  • 其他文件以原生格式提供

📄 許可證

請參閱項目的許可文件以獲取詳細信息。

📞 聯繫方式

如有任何問題，請通過以下方式聯繫：

• 郵件：your.email@example.com
• GitHub 倉庫：github.com/username/repo