
Google Drive server

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 密钥文件。
使用教程
使用依赖
- 创建 Google Cloud 项目并启用 Google Drive API 和 Google Sheets API。
- 配置 OAuth 同意屏幕并下载 OAuth 密钥文件。
安装教程
- 将 OAuth 密钥文件重命名为
gcp-oauth.keys.json
并放置在GDRIVE_CREDS_DIR
指定的目录中。 - 在项目根目录创建
.env
文件,配置以下环境变量: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
触发认证步骤。 - 在浏览器中完成认证。
- 认证成功后,OAuth 令牌将保存在
GDRIVE_CREDS_DIR
指定的目录中。