🚀 Google Drive & Sheets MCP 服务器
本项目是一个用 Rust 编写的 Model Context Protocol (MCP) 服务器，可实现与 Google Drive 和 Google Sheets 的交互。它为 Google Workspace 服务提供了 MCP 兼容接口，能够作为更大代理工作流和组合的一部分使用，极大地拓展了 Google Workspace 服务的应用场景。
✨ 主要特性
Google Drive 操作
- 文件列表筛选：可列出 Google Drive 中的文件，并带有丰富的过滤选项，如按 MIME 类型筛选、自定义搜索查询、可配置的每页大小以及自定义排序。
Google Sheets 操作
- 数据读写：支持从 Google Sheets 读取数据，可指定范围、选择主要维度（行或列）；也能将数据写入 Google Sheets。
- 电子表格管理：能创建新电子表格，可自定义标题并设置多个工作表；还可清除电子表格范围内的值。
📚 详细文档
MCP 集成
此服务器实现了 Model Context Protocol (MCP)，与代理框架（如 Distri）兼容。每个服务通过 MCP 工具公开其功能：
Drive 工具
list_files：可按自定义参数列出和筛选 Drive 文件。- 可用功能通过
resources/list端点公开。
Sheets 工具
read_values：可控制维度读取电子表格数据。write_values：用于将数据写入电子表格。create_spreadsheet：创建新电子表格。clear_values：清除范围内的值。- 可用功能通过
resources/list端点公开。
📦 安装指南
先决条件
- Rust（最新稳定版本）
- 启用了 Drive 和 Sheets API 的 Google Cloud 项目
- 配置了 Google OAuth 2.0 凭证
安装步骤
直接从 GitHub 使用 Cargo 安装 mcp-google 二进制文件：
cargo install --git https://github.com/distrihub/mcp-google-workspace.git
这将把 mcp-google 命令安装到您的系统。
🔧 配置说明
使用服务器之前，您需要执行以下操作：
- 设置 Google Cloud 项目。
- 启用 Google Drive 和 Google Sheets API。
- 创建 OAuth 2.0 凭证。
- 设置环境变量：
ACCESS_TOKEN：您的 Google OAuth 访问令牌。GOOGLE_CLIENT_ID：您的 OAuth 客户端 ID。GOOGLE_CLIENT_SECRET：您的 OAuth 客户端密钥。GOOGLE_REFRESH_TOKEN：您的 OAuth 刷新令牌。
💻 使用示例
作为 MCP 服务器
可以独立启动各个服务器，并通过 MCP 协议使用标准输入输出进行通信：
启动 Drive MCP 服务器
mcp-google drive --access-token
启动 Sheets MCP 服务器
mcp-google sheets --access-token