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控制台
   • 点击“新建项目”
   • 输入项目名称（例如，“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桌面客户端”
   • 点击“创建”
   • 在弹出窗口中：
     • 点击“下载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-m-mp-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. 搜索文件：

   // 搜索包含“季度报告”的文档
   const result = await gdrive_search({ query: "季度报告" });
   

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
• 模型上下文协议文档