MCP Google Drive Server

# 🔧 Technical Documentation *Advanced setup and development guide for developers and technical users.* ## 🏗️ Architecture Overview ``` ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │ Claude AI │◄──►│ MCP Server │◄──►│ Google Drive │ │ │ │ │ │ API │ └─────────────────┘ └─────────────────┘ └─────────────────┘ │ │ │ │ │ │ WebSocket/ Node.js HTTPS/ stdio transport Express OAuth2 ``` ### Components - **MCP Server**: Node.js application implementing the Model Context Protocol - **Google Drive Client**: googleapis library for Drive API interactions - **Authentication Layer**: Supports both Service Account and OAuth 2.0 - **Transport**: stdio-based communication with Claude Desktop ## 📁 Project Structure ``` mcp-google-drive-server/ ├── server.js # Main MCP server implementation ├── auth.js # OAuth authentication helper ├── test.js # Basic functionality test ├── debug-test.js # Authentication debugging ├── package.json # Node.js dependencies ├── service-account.json # Service account credentials (not in repo) ├── credentials.json # OAuth credentials (not in repo) ├── token.json # OAuth tokens (not in repo) ├── docs/ # Documentation │ ├── SETUP-GUIDE.md │ ├── FAQ.md │ └── TROUBLESHOOTING.md └── README.md # Main documentation ``` ## 🔐 Authentication Methods ### Service Account (Recommended for Production) **Pros:** - No user interaction required - Suitable for server environments - Consistent access without token expiration - Can be shared across team members **Cons:** - Requires explicit folder sharing - More complex initial setup - Requires Google Cloud project management **Implementation:** ```javascript const auth = new google.auth.GoogleAuth({ credentials: serviceAccount, scopes: [ 'https://www.googleapis.com/auth/drive', 'https://www.googleapis.com/auth/drive.file', 'https://www.googleapis.com/auth/drive.readonly', 'https://www.googleapis.com/auth/drive.metadata.readonly' ] }); ``` ### OAuth 2.0 (For Development/Personal Use) **Pros:** - Access to user's entire Drive (with permission) - Easier for personal use - Standard Google OAuth flow **Cons:** - Requires periodic re-authentication - User interaction needed for initial setup - Tokens can expire **Implementation:** ```javascript const oAuth2Client = new google.auth.OAuth2( client_id, client_secret, redirect_uris[0] ); ``` ## 🛠️ API Implementation ### Tool Definitions The server implements these MCP tools: | Tool | Description | Parameters | |------|-------------|------------| | `list_files` | List and search files | `query`, `maxResults`, `folderId`, `includeShared` | | `read_file` | Read file contents | `fileId` | | `create_file