Сервер Google Диска

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

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

Компоненты

Инструменты

• gdrive_search

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

  • Вход :

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

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

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

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

• gdrive_read_file

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

  • Вход :

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

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

• gsheets_read

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

  • Вход :

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

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

    • sheetId (число, необязательно): Конкретный идентификатор листа для чтения. Если не указаны диапазоны, считывается первый лист.

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

• gsheets_update_cell

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

  • Вход :

    • fileId (строка): идентификатор электронной таблицы.

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

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

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

Ресурсы

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

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

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

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

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

    • Таблицы → CSV

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

    • Рисунки → PNG

  • Остальные файлы предоставляются в их родном формате.

Related MCP server: Google Drive MCP Server

Начиная

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

2. Включить API Google Диска

3. Настройте экран согласия OAuth («внутренний» подойдет для тестирования)

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

5. Чтобы разрешить взаимодействие с таблицами и документами, вам также необходимо включить API Google Таблиц и API Google Документов в разделе «Включенные API и службы» вашего рабочего пространства.

6. Создайте идентификатор клиента OAuth для типа приложения «Приложение для настольного компьютера»

7. Загрузите JSON-файл ключей OAuth вашего клиента

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

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

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 в репозитории проекта.