🚀 MCP Google Drive Server

Một MCP (Model Context Protocol) Server đầy đủ tính năng cho Google Drive, tương thích với tất cả AI clients hỗ trợ MCP:

• ✅ Antigravity (Google DeepMind)
• ✅ Claude Desktop (Anthropic)
• ✅ Claude Code (CLI)
• ✅ Cursor
• ✅ Windsurf
• ✅ Continue.dev
• ✅ Và bất kỳ MCP-compatible client nào khác

🧩 Tính năng

| Tool | Mô tả | |------|-------| | list_files | Liệt kê files/folders trong Drive | | search_files | Tìm kiếm theo tên hoặc nội dung | | get_file_info | Xem metadata chi tiết của file | | read_file | Đọc nội dung file (Docs, Sheets, text...) | | create_file | Tạo file mới với nội dung | | update_file | Cập nhật nội dung file | | create_folder | Tạo thư mục mới | | delete_file | Xóa file (vào thùng rác hoặc vĩnh viễn) | | restore_file | Khôi phục từ thùng rác | | move_file | Di chuyển file sang folder khác | | copy_file | Sao chép file | | rename_file | Đổi tên file/folder | | share_file | Chia sẻ với người dùng hoặc công khai | | get_permissions | Xem danh sách quyền chia sẻ | | get_storage_quota | Xem dung lượng Drive |

⚙️ Cài đặt

Bước 1: Clone và cài dependencies

git clone https://github.com/mrbit-dev/mcp-google-driver.git
cd mcp-google-driver
npm install

Bước 2: Tạo Google Cloud Project và OAuth2 Credentials

1. Truy cập Google Cloud Console
2. Tạo project mới hoặc chọn project có sẵn
3. Vào APIs & Services > Enable APIs
4. Bật Google Drive API
5. Vào APIs & Services > Credentials
6. Tạo OAuth 2.0 Client ID:
   • Application type: Desktop app
   • Tải file JSON về
7. Copy client_id và client_secret

Bước 3: Tạo file .env

cp .env.example .env

Mở .env và điền thông tin:

GOOGLE_CLIENT_ID=your_client_id.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=your_client_secret

Bước 4: Lấy Refresh Token

npm run build

Script sẽ tự động mở trình duyệt, bạn đăng nhập và cấp quyền, sau đó refresh token sẽ được tự động lưu vào .env.

Bước 5: Build project

npm run build

🔧 Cấu hình MCP Client

Antigravity / Claude Desktop

Thêm vào file claude_desktop_config.json (Windows: %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "google-drive": {
      "command": "node",
      "args": ["/path/to/mcp-google-driver/dist/index.js"],
      "env": {
        "GOOGLE_CLIENT_ID": "your_client_id",
        "GOOGLE_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Lưu ý: Nếu đã có file .env trong project directory, bạn có thể bỏ qua phần env trong config (dotenv sẽ tự load).

[!IMPORTANT] Chú ý về đường dẫn (/path/to/mcp-google-drive/): Bạn cần thay thế /path/to/mcp-google-drive bằng đường dẫn thư mục thực tế trên máy tính của bạn sau khi clone dự án về (ví dụ: C:/projects/mcp-google-drive/dist/index.js hoặc e:/laragon/www/MCP_GOOGLE_Driver/dist/index.js).

Claude Code (CLI)

claude mcp add google-drive node /path/to/mcp-google-drive/dist/index.js

Hoặc thêm vào .claude/settings.json:

{
  "mcpServers": {
    "google-drive": {
      "command": "node",
      "args": ["/path/to/mcp-google-drive/dist/index.js"]
    }
  }
}

Cursor

Thêm vào ~/.cursor/mcp.json:

{
  "mcpServers": {
    "google-drive": {
      "command": "node",
      "args": ["/path/to/mcp-google-drive/dist/index.js"]
    }
  }
}

Windsurf

Thêm vào ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "google-drive": {
      "command": "node",
      "args": ["/path/to/mcp-google-drive/dist/index.js"]
    }
  }
}

🧪 Test với MCP Inspector

npm run inspector

Mở trình duyệt tại http://localhost:5173 để kiểm tra từng tool.

🔐 Bảo mật

• File .env và service-account-key.json đã được thêm vào .gitignore
• KHÔNG commit credentials lên Git
• Sử dụng refresh token thay vì access token (tự động làm mới)
• Hỗ trợ Service Account cho server-to-server authentication

🐛 Troubleshooting

Lỗi "Missing credentials"

→ Kiểm tra file .env đã có đủ GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REFRESH_TOKEN

Lỗi "Access denied"

→ Chạy lại npm run auth để lấy refresh token mới

Lỗi "Cannot find module"

→ Chạy npm run build trước khi start

Lỗi CORS hoặc redirect_uri_mismatch

→ Đảm bảo OAuth Client Type là Desktop app (không phải Web app)