Skip to main content
Glama
saydurrahman-ORCA

orca-drive-sa-mcp

ORCA Drive SA MCP

Сервер Model Context Protocol (MCP), который предоставляет доступ к папке Google Drive через Streamable HTTP, развёрнутый как serverless-функция Vercel.

Он читает Google Drive через сервисный аккаунт Google (Drive API v3, доступ только на чтение), поэтому веб-приложение Apps Script не требуется.

Инструменты

Инструмент

Описание

list_files

Список файлов в папке (по умолчанию — DRIVE_FOLDER_ID)

search_files

Поиск файлов по подстроке в имени

get_file

Получение метаданных одного файла по ID

read_file

Чтение текстового содержимого файла (JSON, CSV, TXT и т. д.)

Related MCP server: Google Drive MCP Server

1. Создайте сервисный аккаунт Google

  1. Перейдите на https://console.cloud.google.com и создайте (или выберите) проект.

  2. Включите Google Drive API (APIs & Services → Library → «Google Drive API»).

  3. Создайте сервисный аккаунт:

    • APIs & Services → Credentials → Create credentials → Service account.

    • Укажите имя и нажмите Create and continue, затем Done.

  4. Сгенерируйте ключ:

    • Откройте сервисный аккаунт → Keys → Add key → Create new key → JSON.

    • Скачайте JSON-файл ключа.

  5. Скопируйте email сервисного аккаунта (например, orca-drive@my-project.iam.gserviceaccount.com).

  6. Предоставьте доступ к целевой папке Drive этому email (правый клик по папке в Drive → Share → вставьте email → Viewer).

Доступны только те файлы/папки, которыми поделились с сервисным аккаунтом.

2. Настройте переменные окружения

Скопируйте .env.example в .env (локальная разработка) и задайте те же значения в Vercel (Project > Settings > Environment Variables):

Переменная

Описание

GOOGLE_SERVICE_ACCOUNT_JSON

Полное содержимое JSON-ключа (в одну строку)

GOOGLE_SERVICE_ACCOUNT_JSON_ENCODED

Установите base64, если значение JSON закодировано в base64

DRIVE_FOLDER_ID

ID папки по умолчанию для вывода списка

3. Локальный запуск

npm install
vercel dev

Проверьте с помощью MCP Inspector (npx @modelcontextprotocol/inspector), используя транспорт Streamable HTTP и URL http://localhost:3000/.

4. Деплой на Vercel

vercel --prod

Ваш endpoint будет https://<project>.vercel.app/.

5. Подключение клиента

Claude Desktop (claude_desktop_config.json):

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

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    C
    maintenance
    An MCP server that enables interaction with Google Drive through the Google Cloud API. It allows users to list, read, and upload files directly from MCP-compatible clients like manus.im or Cursor.
    -
  • A
    license
    A
    quality
    D
    maintenance
    A local MCP server that enables LLMs to securely search and read files within designated Google Drive folders. Supports Google Docs, Google Sheets, PDFs, and plain text with strict folder-scoping via service account authentication.
    4
    MIT