项目介绍
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。如果没有提供范围，则读取第一个工作表。
- 输出: 返回指定的数据。
-
gsheets_update_cell
- 描述: 更新 Google 表格中的单元格值。
- 输入:
fileId(字符串): 表格 ID。range(字符串): A1 标记的单元格范围（例如，'Sheet1!A1'）。value(字符串): 新的单元格值。
- 输出: 确认指定单元格已更新的值。
资源
该服务器提供了对 Google Drive 文件的访问：
- 文件 (
gdrive:///<file_id>)- 支持所有文件类型
- Google Workspace 文件会自动导出：
- 文档 → Markdown
- 表格 → CSV
- 幻灯片 → 纯文本
- 绘图 → PNG
- 其他文件以原生格式提供
快速开始
- 创建一个新的 Google Cloud 项目
- 启用 Google Drive API
- 配置 OAuth 同意屏幕（测试时“内部”即可）
- 添加 OAuth 范围
https://www.googleapis.com/auth/drive.readonly和https://www.googleapis.com/auth/spreadsheets - 为应用类型“桌面应用”创建一个 OAuth 客户端 ID
- 下载客户端 OAuth 密钥的 JSON 文件
- 将密钥文件重命名为
gcp-oauth.keys.json并放置到您指定的GDRIVE_CREDS_DIR路径（例如/Users/username/.config/mcp-gdrive） - 记录您的 OAuth 客户端 ID 和客户端密钥。它们必须作为环境变量与您的配置目录一起提供。
确保使用 npm run build 或 npm run watch 构建服务器。
通过 Smithery 安装
要通过 Smithery 自动安装 drive-mcp 到 Claude Desktop：
npx -y @smithery/cli install @rishipradeep-think41/drive-mcp --client claude
认证
在向 Google 的 API 发送请求之前，您将被提示通过浏览器进行认证。您必须使用与您的 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 文件。