Google Drive & Sheets MCP Server

Google Drive 和 Sheets MCP 服务

这是一个使用 Rust 构建的 Model Context Protocol（MCP）服务，用于与 Google Drive 和 Google Sheets 交互。该工具为 Google Workspace 服务提供兼容 MCP 的接口，可作为更大型 Agent 工作流和组合的一部分使用。

功能

Google Drive 操作

• 列出 Google Drive 中的文件，并提供筛选选项：
  • 按 MIME 类型筛选
  • 自定义搜索查询
  • 可配置的页面大小
  • 自定义排序

Google Sheets 操作

• 从 Google Sheets 读取数据，并提供以下选项：
  • 指定范围
  • 选择主要维度（ROWS 或 COLUMNS）
• 向 Google Sheets 写入数据
• 创建新的电子表格，并支持：
  • 自定义标题
  • 多个工作表
• 清除电子表格范围内的值

MCP 集成

此服务实现了 Model Context Protocol（MCP），因此兼容 Distri 等 Agent 框架。每项服务都会将其功能作为 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 Cloud 项目配置的 OAuth 2.0 凭据

安装

使用 Cargo 直接从 GitHub 安装 mcp-google 二进制文件：

cargo install --git https://github.com/distrihub/mcp-google-workspace.git

这将在你的系统上安装 mcp-google 命令。

配置

使用此服务前，你需要：

1. 设置 Google Cloud 项目
2. 启用 Google Drive 和 Google Sheets APIss
3. 创建 OAuth 2.0 凭据
4. 设置环境变量：
   • ACCESS_TOKEN：你的 Google OAuth 访问令牌
   • GOOGLE_CLIENT_ID：你的 OAuth 客户端 ID
   • GOOGLE_CLIENT_SECRET：你的 OAuth 客户端密钥
   • GOOGLE_REFRESH_TOKEN：你的 OAuth 刷新令牌

用法

作为 MCP 服务

这些服务可以独立启动，并通过 stdio 使用 MCP 协议进行通信：

启动 Drive MCP 服务：

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

启动 Sheets MCP 服务：

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

与 Distri 搭配使用

此服务可作为 Distri Agent 配置的一部分使用：

agents:
  google_workspace:
    drive:
      type: mcp
      command: ["mcp-google", "drive", "--access-token", "${ACCESS_TOKEN}"]
    sheets:
      type: mcp
      command: ["mcp-google", "sheets", "--access-token", "${ACCESS_TOKEN}"]

令牌管理

刷新 OAuth 令牌：

mcp-google refresh \
  --client-id <your-client-id> \
  --client-secret <your-client-secret> \
  --refresh-token <your-refresh-token>

许可证

此项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

贡献

欢迎贡献！请随时提交 Pull Request。

注意

这是一个与 MCP 兼容、可与 Google 服务交互的服务。使用此工具前，请确保你拥有适当的权限和凭据。