ORCA Drive SA MCP

Un servidor de Model Context Protocol (MCP) que expone una carpeta de Google Drive a través de Streamable HTTP, desplegado como una función serverless de Vercel.

Lee Google Drive mediante una cuenta de servicio de Google (Drive API v3, ámbito de solo lectura), por lo que no se necesita una aplicación web de Apps Script.

Herramientas

Related MCP server: Google Drive MCP Server

1. Crear una cuenta de servicio de Google

1. Ve a https://console.cloud.google.com y crea (o selecciona) un proyecto.

2. Habilita la API de Google Drive (APIs y servicios → Biblioteca → "Google Drive API").

3. Crea una cuenta de servicio:

   • APIs y servicios → Credenciales → Crear credenciales → Cuenta de servicio.

   • Dale un nombre y haz clic en Crear y continuar, luego Listo.

4. Genera una clave:

   • Abre la cuenta de servicio → Claves → Agregar clave → Crear clave nueva → JSON.

   • Descarga el archivo de clave JSON.

5. Copia el correo electrónico de la cuenta de servicio (por ejemplo, orca-drive@my-project.iam.gserviceaccount.com).

6. Comparte la carpeta de Drive de destino con ese correo (haz clic derecho en la carpeta en Drive → Compartir → pega el correo → Lector).

Solo se puede acceder a los archivos/carpetas compartidos con la cuenta de servicio.

2. Configurar variables de entorno

Copia .env.example a .env (desarrollo local) y establece los mismos valores en Vercel (Proyecto > Configuración > Variables de entorno):

3. Ejecutar localmente

npm install
vercel dev

Prueba con el MCP Inspector (npx @modelcontextprotocol/inspector) usando el transporte Streamable HTTP y la URL http://localhost:3000/.

4. Desplegar en Vercel

vercel --prod

Tu endpoint será https://<project>.vercel.app/.

5. Conectar un cliente

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "orca-drive-sa": {
      "type": "http",
      "url": "https://<project>.vercel.app/"
    }
  }
}