Google Drive 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. 下載客戶端的 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"]
    }
  }
}

NPX

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gdrive"
      ]
    }
  }
}

✨ 主要特性

工具

• search
  • 可在 Google Drive 中精準搜索文件。
  • 輸入：query（字符串），用於輸入搜索查詢。
  • 返回匹配文件的名稱和 MIME 類型。

資源

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

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

📄 許可證

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