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

Сервер 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
- Остальные файлы предоставляются в их родном формате.

Начиная

Создайте новый проект Google Cloud
Включить API Google Диска
Настройте экран согласия OAuth («внутренний» подойдет для тестирования)
Добавить области OAuth https://www.googleapis.com/auth/drive.readonly , https://www.googleapis.com/auth/spreadsheets
Чтобы разрешить взаимодействие с таблицами и документами, вам также необходимо включить API Google Таблиц и API Google Документов в разделе «Включенные API и службы» вашего рабочего пространства.
Создайте идентификатор клиента OAuth для типа приложения «Приложение для настольного компьютера»
Загрузите JSON-файл ключей OAuth вашего клиента
Переименуйте файл ключа в gcp-oauth.keys.json и поместите его в путь, указанный вами с помощью GDRIVE_CREDS_DIR (например, /Users/username/.config/mcp-gdrive ).
Запишите свой OAuth Client ID и Client Secret. Они должны быть предоставлены как переменные среды вместе с вашим каталогом конфигурации.
Вам также понадобится настроить файл .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 в репозитории проекта.

Google Drive MCP Server

Integrations