Google Drive server

Google Drive server

site icon
2025.03.26 72
TypeScript文件管理开发效率文件管理开发效率
mcp-gdrive 是一个与 Google Drive 集成的 MCP 服务器,提供文件列表、读取、搜索功能,以及 Google Sheets 的读写能力。该服务器支持多种文件类型的自动转换,如将 Google Docs 转换为 Markdown,Sheets 转换为 CSV 等。
View on GitHub

Overview

基本能力

产品定位

mcp-gdrive 是一个与 Google Drive 集成的 MCP 服务器,主要用于文件管理和表格数据处理。

核心功能

  • 文件搜索:支持在 Google Drive 中搜索文件。
  • 文件读取:支持读取 Google Drive 中的文件内容。
  • 表格读取:支持从 Google Sheets 中读取数据。
  • 表格更新:支持更新 Google Sheets 中的单元格值。

适用场景

  • 需要从 Google Drive 中批量读取或搜索文件的场景。
  • 需要从 Google Sheets 中读取或更新数据的场景。

工具列表

  • gdrive_search:搜索 Google Drive 中的文件。
  • gdrive_read_file:读取 Google Drive 中的文件内容。
  • gsheets_read:从 Google Sheets 中读取数据。
  • gsheets_update_cell:更新 Google Sheets 中的单元格值。

常见问题解答

  • 如何配置 OAuth 认证?
  • 需要创建 Google Cloud 项目并启用 Google Drive API 和 Google Sheets API。
  • 配置 OAuth 同意屏幕并下载 OAuth 密钥文件。

使用教程

使用依赖

  1. 创建 Google Cloud 项目并启用 Google Drive API 和 Google Sheets API。
  2. 配置 OAuth 同意屏幕并下载 OAuth 密钥文件。

安装教程

  1. 将 OAuth 密钥文件重命名为 gcp-oauth.keys.json 并放置在 GDRIVE_CREDS_DIR 指定的目录中。
  2. 在项目根目录创建 .env 文件,配置以下环境变量: GDRIVE_CREDS_DIR=/path/to/config/directory CLIENT_ID=<CLIENT_ID> CLIENT_SECRET=<CLIENT_SECRET>
  3. 使用 npm run buildnpm run watch 构建服务器。

调试方式

  1. 运行 node ./dist/index.js 触发认证步骤。
  2. 在浏览器中完成认证。
  3. 认证成功后,OAuth 令牌将保存在 GDRIVE_CREDS_DIR 指定的目录中。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。