Drive File Browser MCP

Un servidor de Model Context Protocol (MCP) que permite a los asistentes de IA — Claude Desktop, Claude Code, Cursor, opencode o cualquier cliente MCP — explorar, buscar y leer archivos de una carpeta de Google Drive.

Funciona en dos modos:

• Local (stdio) — para clientes MCP de escritorio

• Remoto (HTTP, Streamable) — desplegado en Vercel: https://drive-file-browser-mcp.vercel.app/api/mcp

Herramientas proporcionadas

Related MCP server: mcp-google-gdrive

Despliegue remoto (Vercel)

El servidor está disponible en:

https://drive-file-browser-mcp.vercel.app/api/mcp

Utiliza el transporte HTTP Streamable sin estado, por lo que funciona con cualquier cliente MCP que admita servidores HTTP remotos. El endpoint está protegido con una clave de API Bearer.

Conectar un cliente

Claude Desktop / Claude Code (claude_desktop_config.json o .mcp.json):

{
  "mcpServers": {
    "drive-browser": {
      "type": "http",
      "url": "https://drive-file-browser-mcp.vercel.app/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

Cualquier cliente HTTP — envía JSON-RPC por POST con las cabeceras Content-Type: application/json, Accept: application/json, text/event-stream, Authorization: Bearer <TU_CLAVE_API>:

curl -X POST https://drive-file-browser-mcp.vercel.app/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

Comprobación de estado (sin autenticación): GET https://drive-file-browser-mcp.vercel.app/api/health

Desplegar tu propia instancia

1. Haz fork/clona este repositorio y luego:

npm install
npm i -g vercel
vercel login
vercel link --yes
# env vars:
echo "<your-api-key>" | vercel env add MCP_API_KEY production
echo "<your-drive-folder-id>" | vercel env add DRIVE_ROOT_FOLDER_ID production
echo "<service-account-json-contents>" | vercel env add GOOGLE_SERVICE_ACCOUNT_JSON production
vercel deploy --prod --yes

2. Obtén un JSON de cuenta de servicio de Google (ver más abajo) y comparte tu carpeta de Drive con su client_email.

Variables de entorno (Vercel)

Gestiona estas variables en el panel de Vercel: Project → Settings → Environment Variables.

Configuración local (modo stdio)

1. Crear una cuenta de servicio de Google

1. Ve a la consola de Google Cloud y crea (o selecciona) un proyecto.

2. Habilita la API de Google Drive (APIs & Services → Library → busca "Google Drive API" → Enable).

3. Ve a APIs & Services → Credentials → Create Credentials → Service account.

4. Abre la cuenta de servicio → pestaña Keys → Add key → Create new key → JSON. Se descarga un archivo de clave .json.

5. Comparte la carpeta de Drive con el correo de la cuenta de servicio (que aparece en el archivo JSON como client_email, con un formato similar a xxx@xxx.iam.gserviceaccount.com) — haz clic derecho en la carpeta de Drive → Compartir → introduce ese correo → Viewer.

2. Instalar y compilar

git clone https://github.com/ashrafur02-sys/drive-file-browser-mcp.git
cd drive-file-browser-mcp
npm install
npm run build

3. Configurar

Define las variables de entorno (o copia .env.example a .env — nota: los archivos .env NO se cargan automáticamente; define variables de entorno reales en la configuración de tu cliente MCP, o apunta GOOGLE_SERVICE_ACCOUNT_JSON a una ruta de archivo):

Uso con clientes MCP

Añade la configuración MCP de tu cliente:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "drive-browser": {
      "command": "node",
      "args": ["/absolute/path/to/drive-file-browser-mcp/dist/src/index.js"],
      "env": {
        "GOOGLE_SERVICE_ACCOUNT_JSON": "/absolute/path/to/service-account.json",
        "DRIVE_ROOT_FOLDER_ID": "1TG4ssc_z0FgG2snDapoR_SRu3y16Wxm5"
      }
    }
  }
}

Claude Code / opencode:

{
  "mcpServers": {
    "drive-browser": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/drive-file-browser-mcp/dist/src/index.js"],
      "env": {
        "GOOGLE_SERVICE_ACCOUNT_JSON": "/absolute/path/to/service-account.json",
        "DRIVE_ROOT_FOLDER_ID": "1TG4ssc_z0FgG2snDapoR_SRu3y16Wxm5"
      }
    }
  }
}

Una vez conectado, pide a tu asistente cosas como:

• "Lista los archivos de la carpeta de Drive"

• "Busca la presentación de la reunión de prensa"

• "Lee el archivo de comunicación corporativa"

• "Obtén información sobre el archivo con ID ..."

Notas de seguridad

• El servidor utiliza un alcance de solo lectura de Drive (drive.readonly).

• Nunca hagas commit de tu clave de cuenta de servicio. Está excluida por defecto en .gitignore.

• Cualquiera a quien le des el archivo de clave obtiene acceso de lectura a todo lo que la cuenta de servicio puede ver — comparte el repositorio, no tu clave.

Licencia

MIT