AI导哈

Google Drive文件管理服务

一个基于MCP协议的服务器，为AI编程助手提供在Google Drive上搜索、浏览、下载、上传和组织文件的能力。

  • by codingthefuturewithai
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 codingthefuturewithai/google-drive-mcp-server

使用说明

Google Drive MCP服务器

MCP（模型上下文协议）服务器，使AI编码助手能够在Google Drive上搜索、浏览、下载、上传和组织文件。二进制内容从不进入MCP协议——文件在本地文件系统之间传输。

入门指南

如果你使用的是Claude Code，从克隆到工作服务器的最快路径是：

/setup

这将引导您完成所有操作——谷歌云凭据、OAuth登录、Docker构建和服务器注册。无需事先了解设置知识。

其他有用的斜线命令：

命令 它的作用
/server-overview 扫描服务器并显示所有工具、部署选项和配置
/getting-started 互动导游——根据经验水平选择路线
/add-tool "description" 设计并实现一个带有规划步骤的新MCP工具
/generate-tests tool_name 自动生成工具的单元和集成测试

MCP客户快速入门

有两种方法可以运行服务器： 直接安装 或 Docker容器。两者都需要Google OAuth凭据。

1.获取您的Google凭据

在运行任何设置命令之前，请从Google Cloud Console下载您的OAuth凭据：

  1. 去 谷歌云控制台
  2. 创建项目（或选择现有项目）
  3. 启用 Google Drive API
  4. 配置 OAuth同意屏幕 （选择外部，仅填写必填字段）
  5. 首选 凭证 → 创建凭证 → OAuth客户端ID
  6. 选择 桌面应用，然后下载JSON文件

把下载的文件放在你能找到的地方——安装脚本会询问它的位置，并自动将其复制到正确的位置。

2.克隆仓库并安装依赖项

git clone https://github.com/codingthefuturewithai/google-drive-mcp-server.git
cd google_drive
uv sync

先决条件： Python 3.11+， 紫外线Docker桌面（或Linux上的Docker引擎）

3.运行安装程序

python scripts/setup.py

安装脚本会引导您完成所有操作：

  • 查找您下载的凭据（检查下载或询问路径）
  • 打开浏览器进行谷歌登录（支持多个帐户）
  • 配置Docker容器（端口、下载目录、文件访问挂载）
  • 构建Docker镜像并启动服务器
  • 打印准确信息 claude mcp add 注册服务器的命令

之后使用以下方法管理容器：

python scripts/docker.py status   # Check if running
python scripts/docker.py logs     # Tail container logs
python scripts/docker.py restart  # Restart without rebuild
python scripts/docker.py update   # Rebuild and restart (after code changes)
python scripts/docker.py stop     # Stop and remove container

4.开始使用工具

配置后，您可以要求您的AI助手：

  • “在我的谷歌云端硬盘上搜索预算报告”
  • “下载第四季度演示文稿的PDF格式”
  • “将此文件上载到驱动器上的“项目”文件夹”
  • “列出我的共享文档文件夹的内容”
  • “在我的驱动器上创建一个名为“存档”的新文件夹”

可用工具

工具 目的
搜索文件 按名称或使用结构化驱动器API查询进行搜索
list_folder 列出文件夹内容，文件夹先排序
下载文件 将文件下载/导出到本地文件系统
创建文件 将本地文件上传到驱动器
update_file 替换驱动器上现有文件的内容
获取_文件_信息 获取详细的文件元数据
创建文件夹 在驱动器上创建文件夹

有关完整的参数详细信息，请运行 /server-overview 来自您的AI助手。

特性

  • 全面访问Google Drive（搜索、浏览、下载、上传、组织）
  • 自动导出Google工作区文件（文档→ PDF/DOCX，表格→ XLSX/CSV等）
  • 具有可配置大小限制的可恢复上传
  • 支持平台的默认下载目录(~/Downloads/google_drive/)
  • 多传输支持（STDIO、SSE、流式HTTP）
  • Docker容器支持生命周期管理脚本
  • 基于自动装饰器的异常处理、日志记录和类型转换
  • 使用SQLite后端和关联ID跟踪进行统一日志记录

配置

配置存储在平台适当的位置：

  • macOS： ~/Library/Application Support/google_drive/config.yaml
  • Linux： ~/.config/google_drive/config.yaml
  • 窗户： %APPDATA%\google_drive\config.yaml

按键设置 google_drive: 章节：

  • client_secret_path：覆盖路径 client_secret.json
  • max_upload_size_mb：上传大小限制（默认500 MB）

下载转到 ~/Downloads/google_drive/ 默认情况下（可配置）。

故障排除

  1. “未找到client_secret.json”错误

    • 确保您已从谷歌云控制台下载OAuth凭据
    • 将文件放置在配置目录中，如下所示： python -c "import platformdirs; print(platformdirs.user_config_dir('google_drive'))"

  2. “授权用户信息不符合预期格式”错误

    • 您可能已经复制了 client_secret.json 作为 token.json。这些是不同的文件。
    • client_secret.json =您的OAuth客户端凭据（您下载此凭据）
    • token.json =OAuth流完成后自动生成
    • 将文件重命名为 client_secret.json 并运行OAuth流

  3. “拒绝访问”错误

    • 重新运行OAuth流以刷新权限
    • 确保在您的Google Cloud项目中启用Drive API

  4. 工具未出现在您的AI助手中

    • 验证MCP服务器是否已注册： claude mcp list
    • 添加服务器后重新启动AI助手

发展

有关开发设置、测试和贡献指南，请参阅 Developpent.md.

需求

  • 直接安装： Python 3.11或3.12， 紫外线
  • Docker： Docker桌面（macOS/Windows）或Docker引擎（Linux）
  • 所有方法： 启用驱动器API和OAuth2客户端凭据的Google Cloud项目
  • 操作系统：Linux、macOS、Windows

许可证

该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。

作者

蒂姆·基钦斯codingthefuturewithai@gmail.com

相关 MCP