金大哥 - google-drive-and-sheets-mcp-server MCP 详情

article

README

🚀 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 <your-access-token>

启动 Sheets MCP 服务器

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

google-drive-and-sheets-mcp-server