Google Drive

Interaja com as APIs do Google Drive, Sheets e Docs.

GitHub
283
Experimente este MCPPatrocinado

Documentação

Servidor Google Drive

Este servidor MCP integra-se ao Google Drive para permitir listar, ler e pesquisar arquivos, além da capacidade de ler e escrever no Google Sheets.

Este projeto inclui código originalmente desenvolvido pela Anthropic, PBC, licenciado sob a Licença MIT deste repositório.

Componentes

Ferramentas

  • gdrive_search

    • Descrição: Pesquisar arquivos no Google Drive.
    • Entrada:
      • query (string): Consulta de pesquisa.
      • pageToken (string, opcional): Token para a próxima página de resultados.
      • pageSize (número, opcional): Número de resultados por página (máx. 100).
    • Saída: Retorna nomes de arquivos e tipos MIME dos arquivos correspondentes.

  • gdrive_read_file

    • Descrição: Ler o conteúdo de um arquivo do Google Drive.
    • Entrada:
      • fileId (string): ID do arquivo a ser lido.
    • Saída: Retorna o conteúdo do arquivo especificado.

  • gsheets_read

    • Descrição: Ler dados de uma planilha do Google com opções flexíveis para intervalos e formatação.
    • Entrada:
      • spreadsheetId (string): O ID da planilha a ser lida.
      • ranges (array de strings, opcional): Array opcional de intervalos em notação A1 (ex.: ['Sheet1!A1:B10']). Se não for fornecido, lê a planilha inteira.
      • sheetId (número, opcional): ID específico da planilha a ser lida. Se não for fornecido com intervalos, lê a primeira planilha.
    • Saída: Retorna os dados especificados da planilha.

  • gsheets_update_cell

    • Descrição: Atualizar o valor de uma célula em uma planilha do Google.
    • Entrada:
      • fileId (string): ID da planilha.
      • range (string): Intervalo de células em notação A1 (ex.: 'Sheet1!A1').
      • value (string): Novo valor da célula.
    • Saída: Confirma o valor atualizado na célula especificada.

Recursos

O servidor fornece acesso aos arquivos do Google Drive:

  • Arquivos (gdrive:///<file_id>)
    • Suporta todos os tipos de arquivo
    • Arquivos do Google Workspace são exportados automaticamente:
      • Documentos → Markdown
      • Planilhas → CSV
      • Apresentações → Texto simples
      • Desenhos → PNG
    • Outros arquivos são fornecidos em seu formato nativo

Primeiros passos

  1. Criar um novo projeto no Google Cloud
  2. Ativar a API do Google Drive
  3. Configurar uma tela de consentimento OAuth ("interno" é suficiente para testes)
  4. Adicionar escopos OAuth https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/spreadsheets
  5. Para permitir a interação com planilhas e documentos, você também precisará ativar a API do Google Sheets e a API do Google Docs na seção de APIs e serviços habilitados do seu workspace.
  6. Criar um ID de cliente OAuth para o tipo de aplicativo "Aplicativo de desktop"
  7. Baixar o arquivo JSON das chaves OAuth do seu cliente
  8. Renomear o arquivo de chave para gcp-oauth.keys.json e colocá-lo no caminho especificado com GDRIVE_CREDS_DIR (ex.: /Users/username/.config/mcp-gdrive)
  9. Anote seu ID de cliente OAuth e Segredo do cliente. Eles devem ser fornecidos como variáveis de ambiente junto com seu diretório de configuração.
  10. Você também precisará configurar um arquivo .env dentro do projeto com os seguintes campos. Você pode encontrar o ID do cliente e o Segredo do cliente na seção Credenciais do Console do Google Cloud.
GDRIVE_CREDS_DIR=/path/to/config/directory
CLIENT_ID=<CLIENT_ID>
CLIENT_SECRET=<CLIENT_SECRET>

Certifique-se de compilar o servidor com npm run build ou npm run watch.

Autenticação

Em seguida, você precisará executar node ./dist/index.js para acionar a etapa de autenticação

Você será solicitado a autenticar com seu navegador. Você deve autenticar com uma conta na mesma organização do seu projeto do Google Cloud.

Seu token OAuth é salvo no diretório especificado pela variável de ambiente GDRIVE_CREDS_DIR.

Authentication Prompt

Uso com o aplicativo de desktop

Para integrar este servidor ao aplicativo de desktop, adicione o seguinte à configuração do servidor do seu aplicativo:

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": ["-y", "@isaacphi/mcp-gdrive"],
      "env": {
        "CLIENT_ID": "<CLIENT_ID>",
        "CLIENT_SECRET": "<CLIENT_SECRET>",
        "GDRIVE_CREDS_DIR": "/path/to/config/directory"
      }
    }
  }
}

Licença

Este servidor MCP é licenciado sob a Licença MIT. Isso significa que você é livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.