gdrive-mcp

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

Он предоставляет два инструмента:

Архитектура

• server.ts — точка входа HTTP-сервера Node.js (MCP-эндпоинт Streamable HTTP).

• src/mcp.ts — определение MCP-сервера + инструменты.

• src/drive.ts — клиент Google Drive с использованием сервисного аккаунта.

Аутентификация — только на чтение (drive.readonly) через сервисный аккаунт Google.

Related MCP server: gdrive-mcp-server

1. Настройка Google Cloud (сервисный аккаунт)

1. Перейдите в Google Cloud Console и создайте проект.

2. Включите Google Drive API: APIs & Services → Library → найдите "Google Drive API" → Включить.

3. Создайте сервисный аккаунт: IAM & Admin → Service Accounts → Create Service Account.

4. Создайте для него JSON-ключ: откройте сервисный аккаунт → Keys → Add Key → Create New Key → JSON. Скачайте файл.

5. Обратите внимание на email сервисного аккаунта (выглядит как name@project.iam.gserviceaccount.com).

6. Предоставьте доступ к папке Drive для этого email:

   • Откройте папку в Google Drive → правой кнопкой мыши → Share.

   • Вставьте email сервисного аккаунта и выдайте ему доступ Viewer.

7. Скопируйте ID папки (часть в URL после /folders/).

2. Локальная настройка

git clone <your-repo-url>
cd gdrive-mcp
npm install

Создайте файл .env (скопируйте из .env.example):

DRIVE_FOLDER_ID=1XM-0CtgvW3PGDekC8qLa2ghxRyvTfjwD
GOOGLE_SERVICE_ACCOUNT_KEY=<base64 of service-account.json>

Закодируйте ключ сервисного аккаунта в base64:

• Linux/macOS: base64 -w0 service-account.json

• PowerShell: [Convert]::ToBase64String([IO.File]::ReadAllBytes("service-account.json"))

3. Деплой на Vercel

Вариант A — Vercel + GitHub (рекомендуется)

1. Запушьте этот репозиторий в GitHub.

2. В Vercel → Добавить новый → Проект → импортируйте GitHub-репозиторий.

3. Добавьте переменные окружения (DRIVE_FOLDER_ID, GOOGLE_SERVICE_ACCOUNT_KEY).

4. Разверните. MCP-эндпоинт будет по адресу:

https://<your-project>.vercel.app

Вариант B — Vercel CLI

npm i -g vercel
vercel login
vercel env add DRIVE_FOLDER_ID
vercel env add GOOGLE_SERVICE_ACCOUNT_KEY
vercel --prod

4. Отправка в GitHub (первый раз)

git init
git add .
git commit -m "Add gdrive-mcp server"
git branch -M main
git remote add origin https://github.com/<you>/gdrive-mcp.git
git push -u origin main

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

Направьте ваш клиент на развёрнутый URL и используйте транспорт Streamable HTTP. Пример claude_desktop_config.json:

{
  "mcpServers": {
    "gdrive": {
      "type": "http",
      "url": "https://<your-project>.vercel.app"
    }
  }
}

Для клиентов, использующих общий формат конфигурации MCP:

{
  "mcpServers": {
    "gdrive": {
      "url": "https://<your-project>.vercel.app"
    }
  }
}

Эндпоинт без состояния (stateless), поэтому каждый запрос создаёт новый транспорт — идеально для serverless. Доступ управляется настройками общего доступа Google Drive для сервисного аккаунта.

Переменные окружения