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 Docs → Markdown
• 📊 Google Sheets → CSV
• 📊 Google Presentations → 文本
• 🎨 Google Drawings → PNG
• 📄 文本/JSON 文件 → UTF-8 文本
• 📦 其他文件 → Base64 编码

🛠️ 快速开始

erequisites

• Node.js (v14 或更高版本)
• npm (5.7 或更高版本)

安装

npm install gdrive-mcp-server

使用示例

import { GDriveMCP } from 'gdrive-mcp-server';

async function main() {
  const gdrive = new GDriveMCP({
    credentialsPath: './credentials.json',
    tokenPath: './token.json'
  });

  // 搜索文件
  const files = await gdrive.search({ query: 'quarterly report' });
  console.log('搜索结果:', files);

  // 读取文件内容
  const contents = await gdrive.read('your-file-id');
  console.log('文件内容:', contents);
}

main().catch(console.error);

📦 配置

创建 Credentials 文件

在 credentials.json 中添加你的 Google Drive 凭据：

{
  "type": "service_account",
  "project_id": "your-project-id",
  "private_key_id": "your-private-key-id",
  "private_key": "your-private-key",
  "client_email": "your-client-email",
  "token_uri": "https://oauth2.googleapis.com/token"
}

认证流程

1. 使用你的 Google 账户访问 Google Cloud Console
2. 创建一个新的项目或选择现有项目。
3. 启用 Drive API v3 API。
4. 创建服务账号并下载 JSON 密钥文件（即 credentials.json）。

授权

运行你的应用以获取必要的 OAuth 令牌：

node src/auth.js

📄 安全

• 所有敏感凭证都存储在 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
• 模型上下文协议文档