AI导哈

Google Drive与Sheets MCP服务器

一个基于Rust构建的模型上下文协议（MCP）服务器，用于与Google Drive和Google Sheets交互，提供MCP兼容接口，适用于大型代理工作流和组合。

  • by distrihub
  • Rust
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 distrihub/mcp-google-workspace

使用说明

Google Drive&Sheets MCP服务器

Rust内置的模型上下文协议（MCP）服务器，用于与Google Drive和Google Sheets交互。该工具为Google Workspace服务提供了与MCP兼容的接口，使其可以用作更大的代理工作流和组合的一部分。

特性

谷歌云端硬盘运营

  • 在Google云端硬盘中列出具有过滤选项的文件：
    • 按MIME类型筛选
    • 自定义搜索查询
    • 可配置的页面大小
    • 定制订购

谷歌表格操作

  • 使用以下选项从Google表格中读取数据：
    • 指定范围
    • 选择主要尺寸（ROWS或COLUMNS）
  • 将数据写入Google表格
  • 使用以下工具创建新的电子表格：
    • 自定义标题
    • 多张纸
  • 从电子表格中的范围中清除值

MCP集成

该服务器实现了模型上下文协议（MCP），使其与代理框架兼容，如 区每个服务都以MCP工具的形式展示其功能：

驱动工具

  • list_files：使用可自定义参数列出和筛选驱动器文件
  • 通过以下方式暴露的可用功能 resources/list 端点

图纸工具

  • read_values：使用维度控制读取电子表格数据
  • write_values：将数据写入电子表格
  • create_spreadsheet：创建新的电子表格
  • clear_values：电子表格中的范围清晰
  • 通过以下方式暴露的可用功能 resources/list 端点

先决条件

  • Rust（最新稳定版本）
  • 启用了Drive和Sheets API的Google Cloud项目
  • 为您的Google Cloud项目配置OAuth 2.0凭据

安装

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

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

这将安装 mcp-google 命令到您的系统。

配置

在使用服务器之前，您需要：

  1. 创建Google Cloud项目
  2. 启用Google云端硬盘和Google表格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>

启动图纸MCP服务器：

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

与Distri一起使用

此服务器可以用作Distri代理配置的一部分：

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许可证获得许可-请参阅 许可证 文件以获取详细信息。

贡献

欢迎投稿！请随时提交拉取请求。

备注

这是一个与MCP兼容的服务器，与谷歌服务交互。在使用该工具之前，请确保您拥有适当的权限和凭据。

相关 MCP