convez.ai
MCP ServerIntegração & APIsIntermediário
Longtran2404

MCP Google Drive

Longtran2404/mcp-google-drive

Integração completa Google Drive com CRUD, busca e compartilhamento

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP avançado para integração com Google Drive, oferecendo operações completas de CRUD, gerenciamento de arquivos, compartilhamento e controle de permissões. Suporta autenticação via OAuth2 e Service Account, com validação de tipos e tratamento robusto de erros.

Instalação

$npx convez-ai Longtran2404/mcp-google-drive

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
1
Acompanhando
0
Saúde
57%
Último commit
há 2 meses
Versão
v1.6.0
Issues abertas
3
Contribuidores
1

Casos de uso

  • Automatizar gerenciamento de arquivos e pastas no Drive
  • Implementar busca avançada e descoberta de documentos
  • Controlar permissões e compartilhamento programaticamente
  • Sincronizar conteúdo entre aplicações e Google Drive

Veredito

MCP server maduro e bem documentado para Google Drive, com suporte completo a operações de arquivo e permissões. Ideal para automação de fluxos que envolvem armazenamento na nuvem, embora exija configuração adequada de credenciais Google.

README

A tradução para o português deste README ainda está na fila.

MCP Google Drive

Advanced MCP server for Google Drive integration with full CRUD operations, file management, and sharing capabilities.

✨ Features

  • File Management: Create, read, update, delete files and folders
  • Search & Discovery: Advanced search with multiple criteria
  • Sharing & Permissions: Manage file sharing and access control
  • Content Operations: Upload, download, and modify file content
  • Drive Operations: List drives, manage shared drives
  • Type Safety: Full TypeScript support with Zod validation
  • Error Handling: Comprehensive error handling and logging

🚀 Quick Setup

Prerequisites

  • Node.js 18+
  • Google Service Account with Drive API enabled
  • Service Account JSON key file

Installation

npm install mcp-google-drive

Environment Setup

Set your Google Service Account credentials:

export GOOGLE_SERVICE_ACCOUNT_KEY='{"type":"service_account",...}'

🔧 Cursor MCP Integration

Automatic Integration

The MCP server is designed to work seamlessly with Cursor. Add this configuration to your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "mcp-google-drive": {
      "command": "npx",
      "args": ["mcp-google-drive@1.3.2"],
      "env": {
        "GOOGLE_SERVICE_ACCOUNT_KEY": "your-service-account-json",
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "info",
        "DISABLE_CONSOLE_OUTPUT": "false"
      },
      "cwd": "/path/to/your/project"
    }
  }
}

Troubleshooting Cursor Integration

If MCP tools are not working in Cursor:

  1. Restart Cursor after updating mcp.json
  2. Check MCP Status: Command Palette → "MCP: Show Servers"
  3. Verify Connection: Command Palette → "MCP: Test Connection"
  4. Check Logs: Look for MCP server startup messages

Manual Server Start

If automatic integration fails, you can start the server manually:

# In your project directory
npm run start

# Or globally
npx mcp-google-drive

🛠️ Available Tools

File Operations

  • search_files - Search files with advanced criteria
  • get_file - Get file metadata and content
  • create_file - Create new files and folders
  • update_file - Update file content and metadata
  • delete_file - Delete files and folders
  • copy_file - Copy files to new locations
  • move_file - Move files between folders

Drive Management

  • get_drive_info - Get drive information
  • list_shared_drives - List available shared drives

Sharing & Permissions

  • get_file_permissions - Get file sharing settings
  • share_file - Share files with users
  • get_file_revisions - Get file version history

📚 Documentation

🧪 Development

Build

npm run build

Development Mode

npm run dev

Linting

npm run lint
npm run lint:fix

📄 License

MIT License - see LICENSE for details.

🤝 Contributing

Contributions welcome! Please read our contributing guidelines and submit pull requests.

📞 Support

Ver o original no GitHub

Bom para

Relacionados