Сервер Google Drive

Этот MCP-сервер интегрируется с Google Drive, позволяя просматривать, читать и искать файлы, а также читать и записывать данные в Google Таблицы.

Этот проект включает код, изначально разработанный Anthropic, PBC, лицензируемый по лицензии MIT из этого репозитория.

Компоненты

Инструменты

• gdrive_search

  • Описание: Поиск файлов в Google Drive.

  • Входные данные:

    • query (строка): Поисковый запрос.

    • pageToken (строка, опционально): Токен для следующей страницы результатов.

    • pageSize (число, опционально): Количество результатов на странице (максимум 100).

  • Выходные данные: Возвращает имена файлов и MIME-типы соответствующих файлов.

• gdrive_read_file

  • Описание: Чтение содержимого файла из Google Drive.

  • Входные данные:

    • fileId (строка): ID файла для чтения.

  • Выходные данные: Возвращает содержимое указанного файла.

• gsheets_read

  • Описание: Чтение данных из Google Таблицы с гибкими настройками диапазонов и форматирования.

  • Входные данные:

    • spreadsheetId (строка): ID таблицы для чтения.

    • ranges (массив строк, опционально): Опциональный массив диапазонов в нотации A1 (например, ['Sheet1!A1:B10']). Если не указан, читается весь лист.

    • sheetId (число, опционально): ID конкретного листа для чтения. Если не указан вместе с ranges, читается первый лист.

  • Выходные данные: Возвращает указанные данные из таблицы.

• gsheets_update_cell

  • Описание: Обновление значения ячейки в Google Таблице.

  • Входные данные:

    • fileId (строка): ID таблицы.

    • range (строка): Диапазон ячеек в нотации A1 (например, 'Sheet1!A1').

    • value (строка): Новое значение ячейки.

  • Выходные данные: Подтверждает обновлённое значение в указанной ячейке.

Ресурсы

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

• Файлы (gdrive:///<file_id>)

  • Поддерживает все типы файлов

  • Файлы Google Workspace автоматически экспортируются:

    • Документы → Markdown

    • Таблицы → CSV

    • Презентации → Обычный текст

    • Рисунки → PNG

  • Другие файлы предоставляются в их родном формате

Related MCP server: Google Drive server

Начало работы

1. Создайте новый проект Google Cloud

2. Включите Google Drive API

3. Настройте экран согласия OAuth (для тестирования подойдёт "internal")

4. Добавьте области OAuth https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/spreadsheets

5. Для взаимодействия с таблицами и документами также необходимо включить Google Sheets API и Google Docs API в разделе "Включённые API и сервисы" вашего рабочего пространства.

6. Создайте идентификатор клиента OAuth для типа приложения "Desktop App"

7. Скачайте JSON-файл с ключами OAuth вашего клиента

8. Переименуйте файл ключа в gcp-oauth.keys.json и поместите его в путь, указанный в GDRIVE_CREDS_DIR (например, /Users/username/.config/mcp-gdrive)

9. Запомните ваш идентификатор клиента OAuth и секрет клиента. Они должны быть переданы как переменные окружения вместе с путём к каталогу конфигурации.

10. Также необходимо создать файл .env внутри проекта со следующими полями. Идентификатор клиента и секрет клиента можно найти в разделе "Учётные данные" консоли Google Cloud.

GDRIVE_CREDS_DIR=/path/to/config/directory
CLIENT_ID=<CLIENT_ID>
CLIENT_SECRET=<CLIENT_SECRET>

Убедитесь, что вы собрали сервер с помощью npm run build или npm run watch.

Аутентификация

Затем вам нужно запустить node ./dist/index.js, чтобы запустить этап аутентификации.

Вам будет предложено пройти аутентификацию в браузере. Вы должны аутентифицироваться с учётной записью в той же организации, что и ваш проект Google Cloud.

Токен OAuth сохраняется в каталоге, указанном в переменной окружения GDRIVE_CREDS_DIR.

Использование с настольным приложением

Чтобы интегрировать этот сервер с настольным приложением, добавьте следующее в конфигурацию серверов вашего приложения:

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": ["-y", "@isaacphi/mcp-gdrive"],
      "env": {
        "CLIENT_ID": "<CLIENT_ID>",
        "CLIENT_SECRET": "<CLIENT_SECRET>",
        "GDRIVE_CREDS_DIR": "/path/to/config/directory"
      }
    }
  }
}

Лицензия

Этот MCP-сервер лицензирован по лицензии MIT. Это означает, что вы можете свободно использовать, изменять и распространять программное обеспечение в соответствии с условиями лицензии MIT. Для получения дополнительной информации обратитесь к файлу LICENSE в репозитории проекта.