Сервер MCP для просмотра файлов Google Drive

Сервер Model Context Protocol (MCP), который позволяет ИИ-ассистентам — Claude Desktop, Claude Code, Cursor, opencode или любому MCP-клиенту — просматривать, искать и читать файлы в папке Google Drive.

Работает в двух режимах:

• Локальный (stdio) — для настольных MCP-клиентов

• Удалённый (HTTP, Streamable) — развёрнут на Vercel: https://drive-file-browser-mcp.vercel.app/api/mcp

Предоставляемые инструменты

Related MCP server: mcp-google-gdrive

Удалённое развёртывание (Vercel)

Сервер доступен по адресу:

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

Он использует транспорт Streamable HTTP без сохранения состояния, поэтому работает с любым MCP-клиентом, поддерживающим удалённые HTTP-серверы. Конечная точка защищена Bearer-ключом API.

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

Claude Desktop / Claude Code (claude_desktop_config.json или .mcp.json):

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

Любой HTTP-клиент — отправляйте JSON-RPC через POST с заголовками Content-Type: application/json, Accept: application/json, text/event-stream, Authorization: Bearer <YOUR_API_KEY>:

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"}}}'

Проверка работоспособности (без авторизации): GET https://drive-file-browser-mcp.vercel.app/api/health

Собственное развёртывание

1. Сделайте форк/клонируйте этот репозиторий, затем:

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. Получите JSON-ключ сервисного аккаунта Google (см. ниже) и предоставьте доступ к своей папке Drive, указав его client_email.

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

Управление ими в панели Vercel: Project → Settings → Environment Variables.

Локальная настройка (режим stdio)

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

1. Перейдите в Google Cloud Console и создайте (или выберите) проект.

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

3. Перейдите в APIs & Services → Credentials → Create Credentials → Service account.

4. Откройте сервисный аккаунт → вкладка Keys → Add key → Create new key → JSON. Скачается JSON-файл с ключом.

5. Предоставьте доступ к папке Drive на email сервисного аккаунта (указан в JSON-файле как client_email, выглядит как xxx@xxx.iam.gserviceaccount.com) — нажмите правой кнопкой на папку в Drive → Share → введите этот email → Viewer.

2. Установка и сборка

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

3. Настройка

Задайте переменные окружения (или скопируйте .env.example в .env — обратите внимание: файлы .env НЕ загружаются автоматически; задавайте реальные переменные окружения в конфигурации MCP-клиента или укажите путь к файлу в GOOGLE_SERVICE_ACCOUNT_JSON):

Использование с MCP-клиентами

Добавьте в конфигурацию вашего MCP-клиента:

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"
      }
    }
  }
}

После подключения вы можете спрашивать ассистента, например:

• "Перечисли файлы в папке Drive"

• "Найди презентацию для пресс-встречи"

• "Прочитай корпоративный документ"

• "Получи информацию о файле с ID ..."

Замечания по безопасности

• Сервер использует доступ только на чтение к Drive (область drive.readonly).

• Никогда не коммитьте ключ сервисного аккаунта в репозиторий. Он игнорируется через .gitignore по умолчанию.

• Любой, у кого есть файл ключа, получает доступ на чтение ко всем ресурсам, доступным сервисному аккаунту — делитесь репозиторием, но не ключом.

Лицензия

MIT