shield_lock
金大哥
← 返回 MCP 目录
public公开dns本地运行

mcp-google-spreadsheet

Google表格与云端硬盘的MCP服务工具

article

README

🚀 MCP 谷歌电子表格

MCP（模型上下文协议）服务器借助 Google Spreadsheet 和 Google Drive 操作工具实现。使用该工具，AI 助手能够对 Google Spreadsheet 或 Google Drive 文件进行操作，为相关工作带来便利。

🚀 快速开始

MCP 谷歌电子表格可让 AI 助手操作 Google Spreadsheet 和 Google Drive 文件。使用前需完成安装和配置，具体步骤如下。

✨ 主要特性

Google Drive 操作

  • list_files：获取 Google Drive 文件列表。
  • copy_file：复制 Google Drive 文件。
  • rename_file：修改 Google Drive 文件名。

Google Spreadsheet 操作

  • list_sheets：获取电子表格内的工作表列表。
  • copy_sheet：复制电子表格内的工作表。
  • rename_sheet：修改电子表格内工作表名称。
  • get_sheet_data：获取工作表数据。
  • add_rows：向工作表添加行。
  • add_columns：向工作表添加列。
  • update_cells：更新单个范围的单元格。
  • batch_update_cells：批量更新多个范围的单元格。

📦 安装指南

go install github.com/kazz187/mcp-google-spreadsheet@latest

此命令将在 $GOPATH/bin 目录下安装 mcp-google-spreadsheet 可执行文件。

📚 详细文档

配置

需要设置以下环境变量：

  • MCPGS_CLIENT_SECRET_PATH：Google API 客户端密钥文件路径 (https://developers.google.com/identity/protocols/oauth2/native-app?hl=ja)
  • MCPGS_TOKEN_PATH：Google API 令牌文件路径（若不存在则自动创建）
  • MCPGS_FOLDER_ID：操作目标的 Google Drive 文件夹 ID

Google API 设置步骤

  1. 访问 Google Cloud Console
  2. 创建项目
  3. 启用 Google Drive API 和 Google Sheets API
  4. 创建身份验证信息（OAuth 客户端 ID）
  5. 下载客户端密钥

启动

export MCPGS_CLIENT_SECRET_PATH=/path/to/client_secret.json
export MCPGS_TOKEN_PATH=/path/to/token.json
export MCPGS_FOLDER_ID=your_folder_id
mcp

先决条件

  • Go 1.24 或更高版本
  • 已启用 Google Cloud Platform 项目及 API
    • Google Drive API
    • Google Sheets API
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载，用户一般按页面提供的连接方式或授权流程接入，不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖，把 server_config 复制到 MCP 客户端，并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端