MCP Reference: drivemcp.googleapis.com

Este é um servidor MCP fornecido pela API Drive. O servidor oferece ferramentas para desenvolvedores criarem aplicativos de LLM no Drive.

Um servidor do Protocolo de Contexto de Modelo (MCP) atua como um proxy entre um serviço externo que fornece contexto, dados ou recursos a um modelo de linguagem grande (LLM) ou aplicativo de IA. Os servidores MCP conectam aplicativos de IA a sistemas externos, como bancos de dados e serviços da Web, traduzindo as respostas em um formato que o aplicativo de IA possa entender.

Configuração do servidor

Você precisa configurar o servidor MCP do Drive antes de usar. Para mais informações sobre como usar servidores remotos do MCP do Google e do Google Cloud, consulte Visão geral dos servidores do MCP no Google Cloud.

Endpoints de servidor

Um endpoint de serviço do MCP é o endereço de rede e a interface de comunicação (geralmente um URL) do servidor do MCP que um aplicativo de IA (o host do cliente do MCP) usa para estabelecer uma conexão segura e padronizada. É o ponto de contato para o LLM solicitar contexto, chamar uma ferramenta ou acessar um recurso. Os endpoints do Google MCP podem ser globais ou regionais.

O servidor MCP da API Drive tem o seguinte endpoint global do MCP:

  • https://drivemcp.googleapis.com/mcp/v1

Ferramentas do MCP

Uma ferramenta do MCP é uma função ou capacidade executável que um servidor do MCP expõe a um LLM ou aplicativo de IA para realizar uma ação no mundo real.

Ferramentas

O servidor MCP drivemcp.googleapis.com tem as seguintes ferramentas:

Ferramentas do MCP
create_file

Chame essa ferramenta para criar ou fazer upload de um arquivo no Google Drive.

Se você estiver enviando um arquivo, o conteúdo precisa ser codificado em base64 no campo content, independente do tipo MIME do arquivo.

Retorna um único objeto "File" após a criação.

Os seguintes tipos MIME próprios do Google Drive podem ser criados sem fornecer conteúdo:

  • application/vnd.google-apps.document
  • application/vnd.google-apps.spreadsheet
  • application/vnd.google-apps.presentation

Por padrão, as seguintes conversões serão feitas para os seguintes tipos MIME:

  • text/plain a application/vnd.google-apps.document
  • text/csv a application/vnd.google-apps.spreadsheet

Para desativar as conversões de tipos MIME primários, defina disable_conversion_to_google_type como "true".

Para criar pastas, defina o tipo MIME como application/vnd.google-apps.folder.
download_file_content

Chame essa ferramenta para baixar o conteúdo de um arquivo do Drive como dados binários brutos (bytes).

Se o arquivo for um tipo MIME próprio do Google Drive, o campo exportMimeType será obrigatório e vai determinar o formato do arquivo baixado.

Se o arquivo não for encontrado, tente usar outras ferramentas, como search_files, para encontrar o arquivo que o usuário está pedindo.

Se o usuário quiser uma representação em linguagem natural do conteúdo do Drive, use a ferramenta read_file_content (que precisa ser menor e mais fácil de analisar).read_file_content
get_file_metadata

Chame essa ferramenta para encontrar metadados gerais sobre um arquivo do Drive de um usuário.

Se o arquivo não for encontrado, tente usar outras ferramentas, como search_files, para encontrar o arquivo que o usuário está pedindo.
get_file_permissions Chame essa ferramenta para listar as permissões de um arquivo do Drive.
list_recent_files

Chame essa ferramenta para encontrar arquivos recentes de um usuário especificado em uma ordem de classificação. A ordem de classificação padrão é recency.

As ordens de classificação aceitas são:

  • recency: o carimbo de data/hora mais recente dos campos de data e hora do arquivo.
  • lastModified: a última vez que o arquivo foi modificado por alguém.
  • lastModifiedByMe: a última vez que o arquivo foi modificado pelo usuário.

O tamanho de página padrão é 10. Use next_page_token para paginar os resultados.
read_file_content

Chame essa ferramenta para buscar uma representação em linguagem natural de um arquivo do Drive.

O conteúdo de arquivos muito grandes pode estar incompleto. A representação de texto muda com o tempo. Por isso, não faça suposições sobre o formato específico do texto retornado por essa ferramenta.

Tipos MIME compatíveis:

  • application/vnd.google-apps.document
  • application/vnd.google-apps.presentation
  • application/vnd.google-apps.spreadsheet
  • application/pdf
  • application/msword
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
  • application/vnd.openxmlformats-officedocument.presentationml.presentation
  • application/vnd.oasis.opendocument.spreadsheet
  • application/vnd.oasis.opendocument.presentation
  • application/x-vnd.oasis.opendocument.text
  • image/png
  • image/jpeg
  • image/jpg

Se o arquivo não for encontrado, tente usar outras ferramentas, como search_files, para encontrar o arquivo que o usuário está pedindo usando palavras-chave.
search_files

Chame essa ferramenta para pesquisar arquivos do Drive usando uma consulta estruturada.

O campo query exige o uso de operadores de pesquisa de consulta.

Uma string de consulta contém as três partes a seguir: query_term operator values, em que:

  • query_term é o termo ou campo de consulta a ser pesquisado.
  • operator especifica a condição do termo de consulta.
  • values são os valores específicos a serem usados para filtrar os resultados da pesquisa.

Termos de consulta

A tabela a seguir lista termos de consulta válidos com as respectivas descrições:

Termo de consulta Operadores válidos Uso
title contains, =, != Título do arquivo. Coloque entre aspas simples ('). Use o caractere de escape \' em consultas com aspas simples, como 'Valentine\'s Day'.
fullText contains Se o title ou o texto no conteúdo do arquivo correspondem. Coloque entre aspas simples ('). Use o caractere de escape \' em consultas com aspas simples, como 'Valentine\'s Day'.
mimeType contains, =, != Tipo MIME do arquivo. Coloque entre aspas simples ('). Use o caractere de escape \' em consultas com aspas simples, como 'Valentine\'s Day'.
modifiedTime <=, <, =, !=, >, >= Data da última modificação do arquivo. Formato RFC 3339, o fuso horário padrão é UTC, como 2012-06-04T12:00:00-08:00. Campos do tipo date não são comparáveis.
viewedByMeTime <=, <, =, !=, >, >= Data em que o usuário acessou um arquivo pela última vez. Formato RFC 3339, o fuso horário padrão é UTC, como 2012-06-04T12:00:00-08:00. Campos do tipo date não são comparáveis.
parentId =, != Se o pai é igual ao ID especificado. root pode ser usado para especificar o "Meu Drive" do usuário, que funciona como a hierarquia principal.
owner =, != Usuário que é o proprietário do arquivo. me pode ser usado para especificar o usuário que está fazendo a solicitação.
sharedWithMe =, != Arquivos na coleção "Compartilhados comigo" do usuário. Todos os usuários de arquivos estão na lista de controle de acesso (ACL) do arquivo. Pode ser true ou false.
createdTime <=, <, =, !=, >, >= Data em que o arquivo foi criado. Use o formato RFC 3339. O fuso horário padrão é UTC, como 2012-06-04T12:00:00-08:00.

Operadores de consulta

A tabela a seguir lista os operadores de consulta válidos:

Operador Uso
contains O conteúdo de uma string está presente na outra.
= O conteúdo de uma string ou booleano é igual ao outro.
!= O conteúdo de uma string ou booleano não é igual ao outro.
< Um valor é menor que outro.
<= Um valor é menor ou igual a outro.
> Um valor é maior que outro.
>= Um valor é maior ou igual a outro.
in Um elemento está contido em uma coleção.
and Retorna itens que correspondem às duas consultas.
or Retorna itens que correspondem a qualquer uma das consultas.
not Nega uma consulta de pesquisa.
has Uma coleção contém um elemento que corresponde aos parâmetros.

Alguns exemplos de consultas:

  • title contains 'hello' and title contains 'goodbye'
  • modifiedTime > '2024-01-01T00:00:00Z' and (mimeType contains 'image/' or mimeType contains 'video/')
  • parentId = '1234567'
  • fullText contains 'hello'
  • owner = 'test@example.org'
  • sharedWithMe = true
  • owner = 'me' (para arquivos de propriedade do usuário)

Use next_page_token para paginar os resultados. Uma resposta vazia indica que não há resultados ou não há mais resultados para retornar.

Receber especificações da ferramenta MCP

Para receber as especificações de ferramentas do MCP de todas as ferramentas em um servidor MCP, use o método tools/list. O exemplo a seguir demonstra como usar curl para listar todas as ferramentas e especificações disponíveis no servidor MCP.

Solicitação curl 
curl --location 'https://drivemcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'