Google Drive MCP 服务器

一个强大的模型上下文协议 (MCP) 服务器，提供与 Google Drive 的无缝集成，允许 AI 模型搜索、列出和读取 Google Drive 中的文件。

🚀 功能

工具

1. gdrive_search

在您的 Google Drive 中使用强大的全文搜索功能搜索文件。

• 输入:

  {
    "query": "string (您的搜索查询)"
  }
  

• 输出: 文件列表，包含：
  • 文件名
  • MIME 类型
  • 文件 ID
  • 上次修改时间
  • 文件大小

2. gdrive_read_file

使用 Google Drive 文件 ID 直接读取文件内容。

• 输入:

  {
    "file_id": "string (Google Drive 文件 ID)"
  }
  

• 输出: 具有适当格式转换的文件内容

自动文件格式处理

服务器智能地处理不同的 Google Workspace 文件类型：

• 📝 Google 文档 → Markdown
• 📊 Google 表格 → CSV
• 📊 Google 幻灯片 → 纯文本
• 🎨 Google 绘图 → PNG
• 📄 文本/JSON 文件 → UTF-8 文本
• 📦 其他文件 → Base64 编码

🛠️ 入门指南

前提条件

• Node.js (v16 或更高版本)
• npm 或 yarn
• 一个 Google Cloud 项目
• 一个 Google Workspace 或个人 Google 帐户

详细的 Google Cloud 设置

1. 创建一个 Google Cloud 项目

   • 访问 Google Cloud Console
   • 点击 "新建项目"
   • 输入项目名称 (例如，"MCP GDrive Server")
   • 点击 "创建"
   • 等待项目创建完成并选择它

2. 启用 Google Drive API

   • 前往 API 库
   • 搜索 "Google Drive API"
   • 点击 "Google Drive API"
   • 点击 "启用"
   • 等待 API 启用完成

3. 配置 OAuth 同意屏幕

   • 导航至 OAuth 同意屏幕
   • 选择用户类型：
     • 如果您使用 Google Workspace，则选择 "内部"
     • 对于个人 Google 帐户，选择 "外部"
   • 点击 "创建"
   • 填写必填字段：
     • 应用名称: "MCP GDrive Server"
     • 用户支持电子邮件: 您的电子邮件
     • 开发者联系电子邮件: 您的电子邮件
   • 点击 "保存并继续"
   • 在 "范围" 页面：
     • 点击 "添加或移除范围"
     • 添加 https://www.googleapis.com/auth/drive.readonly
     • 点击 "更新"
   • 点击 "保存并继续"
   • 检查摘要并点击 "返回仪表盘"

4. 创建 OAuth 客户端 ID

   • 前往 凭据
   • 点击顶部的 "创建凭据"
   • 选择 "OAuth 客户端 ID"
   • 选择应用类型: "桌面应用"
   • 名称: "MCP GDrive Server Desktop Client"
   • 点击 "创建"
   • 在弹窗中：
     • 点击 "下载 JSON"
     • 保存文件
     • 点击 "确定"

5. 在项目中设置凭据

   # 创建凭据目录
   mkdir credentials
   
   # 移动并重命名下载的 JSON 文件
   mv path/to/downloaded/client_secret_*.json credentials/gcp-oauth.keys.json
   

安装

# 克隆仓库
git clone https://github.com/felores/gdrive-mcp-server.git
cd gdrive-mcp-server

# 安装依赖
npm install

# 构建项目
npm run build

身份验证

1. 创建一个凭据目录并将您的 OAuth 密钥放入其中：

   mkdir credentials
   # 将您下载的 OAuth JSON 文件移动到凭据目录，并命名为 gcp-oauth.keys.json
   

2. 运行身份验证命令：

   node dist/index.js auth
   

3. 在您的浏览器中完成 OAuth 流程

4. 凭据将保存在 credentials/.gdrive-server-credentials.json 中

🔧 用法

作为命令行工具

# 启动服务器
node dist/index.js

与桌面应用程序集成

将此配置添加到您的应用程序的服务器设置中：

{
  "mcpServers": {
    "gdrive": {
      "command": "node",
      "args": ["path/to/gdrive-mcp-server/dist/index.js"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "path/to/gdrive-mcp-server/credentials/gcp-oauth.keys.json",
        "MCP_GDRIVE_CREDENTIALS": "path/to/gdrive-mcp-server/credentials/.gdrive-server-credentials.json"
      }
    }
  }
}

将 path/to/gdrive-mcp-server 替换为您安装目录的实际路径。

使用示例

1. 搜索文件:

   // 搜索包含 "quarterly report" 的文档
   const result = await gdrive_search({ query: "quarterly report" });
   

2. 读取文件内容:

   // 使用其 ID 读取特定文件
   const contents = await gdrive_read_file({ file_id: "your-file-id" });
   

🔒 安全

• 所有敏感凭据都存储在 credentials 目录中
• OAuth 凭据和令牌已从版本控制中排除
• 对 Google Drive 的只读访问权限
• 安全的 OAuth 2.0 身份验证流程

🤝 贡献

欢迎贡献！请随时提交 Pull Request。

📝 许可证

此 MCP 服务器在 MIT 许可证下获得许可。 有关详细信息，请参见 LICENSE 文件。

🔍 故障排除

如果您遇到问题：

1. 验证您的 Google Cloud 项目设置
2. 确保所有必需的 OAuth 范围都已启用
3. 检查凭据是否正确放置在 credentials 目录中
4. 验证 Google Drive 中的文件权限和访问权限

📚 附加资源

• Google Drive API 文档
• OAuth 2.0 for Desktop Apps
• 模型上下文协议文档