Google Drive And Sheets MCP Server

🚀 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 命令安装到您的系统。

🔧 配置说明

使用服务器之前，您需要执行以下操作：

1. 设置 Google Cloud 项目。
2. 启用 Google Drive 和 Google Sheets API。
3. 创建 OAuth 2.0 凭证。
4. 设置环境变量：
   • 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 <your-access-token>

启动 Sheets MCP 服务器

mcp-google sheets --access-token <your-access-token>