MCP Google 表格

作为 Model Context Protocol (MCP) 服务器实现的 Google 表格和 Google 驱动器操作工具。通过使用此工具，AI 助手（如 Claude Desktop）可以操作 Google 表格和 Google 驱动器中的文件。

功能

Google 驱动器操作

• google_drive_list_files: 列出 Google 驱动器内的文件和文件夹
• google_drive_copy_file: 将文件或文件夹复制到其他位置
• google_drive_rename_file: 更改文件或文件夹的名称

Google 表格操作

• google_sheets_list_sheets: 获取工作表（标签）列表
• google_sheets_copy_sheet: 将工作表复制到另一个工作簿
• google_sheets_rename_sheet: 更改工作表的名称
• google_sheets_read_data: 读取工作表的数据（打开工作簿的操作）
• google_sheets_add_rows: 在工作表中插入空行
• google_sheets_add_columns: 在工作表中插入空列
• google_sheets_update_cells: 更新指定范围内单元格的值
• google_sheets_batch_update_cells: 批量更新多个范围内的单元格
• google_sheets_delete_rows: 删除工作表中的行
• google_sheets_delete_columns: 删除工作表中的列

使用流程

1. 使用 google_drive_list_files 查找 Google 驱动器中的文件，找到工作簿
2. 使用 google_sheets_list_sheets 查看特定工作簿中的工作表列表
3. 使用 google_sheets_read_data 显示工作表的内容
4. 根据需要使用其他 google_sheets_* 工具编辑数据

前提条件

• Go 1.24 或更高版本
• 启用 Google Cloud Platform 项目和 API
  • Google 驱动器 API
  • Google 表格 API
• 设置 Google OAuth 2.0 认证

安装

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 驱动器文件夹 ID（右键点击文件夹 -> 获取链接 -> URL 的最后一部分）

Google API 的设置步骤

1. 访问 Google Cloud Console
2. 创建一个项目
3. 启用 Google 驱动器 API 和 Google 表格 API
4. 创建认证信息（OAuth 客户端 ID）
   • 应用程序类型：选择“桌面应用程序”
5. 下载客户端密钥 JSON 文件

使用方法

启动

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-google-spreadsheet

如果您使用 go install 进行了安装，请确保 $GOPATH/bin 在 PATH 中。

首次启动时需要进行认证。浏览器会自动打开并显示 Google 账户的认证页面。完成认证后，浏览器会自动返回到应用程序。如果浏览器没有自动打开，请在控制台中打开显示的 URL。

在 Claude Desktop 中的设置

如果要在 Claude Desktop 中使用，请在设置文件（macOS: ~/Library/Application Support/Claude/claude_desktop_config.json）中添加以下内容：

{
  "mcpServers": {
    "mcp_google_spreadsheet": {
      "command": "mcp-google-spreadsheet",
      "args": [],
      "env": {
        "MCPGS_CLIENT_SECRET_PATH": "/path/to/client_secret.json",
        "MCPGS_TOKEN_PATH": "/path/to/token.json",
        "MCPGS_FOLDER_ID": "your_folder_id"
      }
    }
  }
}

如果您使用 go install 进行了安装，可以在 command 中仅指定可执行文件名，而不是绝对路径。在这种情况下，请确保 MCP 服务器运行用户的 PATH 包含 $GOPATH/bin。

安全性

• 仅限访问指定文件夹 ID 内的文件
• 防止目录遍历攻击（使用 ../ 等路径指定）
• 验证用户指定的文件是否存在于指定文件夹内