关键词

Google SpreadsheetGoogle DriveAPILLM工具

项目简介

本项目 'mcp-google-spreadsheet' 是一个实现了 Model Context Protocol (MCP) 协议的服务器，专注于提供 Google Drive 和 Google Spreadsheet 的操作工具。通过这个服务器，AI 助手（如 Claude、ChatGPT 等 MCP 客户端）可以安全、可控地访问和操作用户授权的 Google Drive 文件和 Google Spreadsheet 数据。

主要功能点

  • Google Drive 操作：

    • 文件列表 (list_files)： 获取指定 Google Drive 文件夹中的文件和文件夹列表。
    • 文件复制 (copy_file)： 复制 Google Drive 中的文件到指定路径。
    • 文件重命名 (rename_file)： 重命名 Google Drive 中的文件。

  • Google Spreadsheet 操作：

    • 工作表列表 (list_sheets)： 获取指定 Google Spreadsheet 文件中的所有工作表列表。
    • 工作表复制 (copy_sheet)： 复制 Google Spreadsheet 中的工作表到新的位置。
    • 工作表重命名 (rename_sheet)： 重命名 Google Spreadsheet 中的工作表。
    • 获取工作表数据 (get_sheet_data)： 获取 Google Spreadsheet 工作表中的数据，可以指定范围。
    • 添加行 (add_rows)： 在 Google Spreadsheet 工作表中添加新的行。
    • 添加列 (add_columns)： 在 Google Spreadsheet 工作表中添加新的列。
    • 更新单元格 (update_cells)： 更新 Google Spreadsheet 工作表中指定范围的单元格数据。
    • 批量更新单元格 (batch_update_cells)： 批量更新 Google Spreadsheet 工作表中多个范围的单元格数据。

安装步骤

  1. 安装 Go 语言环境： 确保你的系统已安装 Go 1.24 或更高版本。
  2. 安装 'mcp-google-spreadsheet'： 打开终端，运行以下命令安装： 
    go install github.com/kazz187/mcp-google-spreadsheet@latest
    安装成功后，'mcp-google-spreadsheet' 可执行文件将被安装到 '$GOPATH/bin' 目录。请确保 '$GOPATH/bin' 目录已添加到系统的 PATH 环境变量中。

服务器配置

要将 'mcp-google-spreadsheet' 配置为 MCP 服务器供客户端使用，需要在 MCP 客户端的配置文件中添加以下服务器配置信息。以下是一个 JSON 格式的配置示例，你需要根据你的实际环境进行修改：

{
  "mcpServers": {
    "mcp_google_spreadsheet": {
      "command": "mcp-google-spreadsheet",  // 启动服务器的命令，如果 'mcp-google-spreadsheet' 已添加到 PATH 环境变量，则可以直接使用命令名，否则需要使用绝对路径
      "args": [],                             // 启动命令的参数，本项目无需额外参数
      "env": {
        "MCPGS_CLIENT_SECRET_PATH": "/path/to/client_secret.json", // Google API 客户端密钥文件路径，请替换为实际路径
        "MCPGS_TOKEN_PATH": "/path/to/token.json",           // Google API 令牌文件路径，程序会自动创建，请替换为你希望保存令牌的路径
        "MCPGS_FOLDER_ID": "your_folder_id"                 // 你希望限制访问的 Google Drive 文件夹 ID，请替换为实际的文件夹 ID
      }
    }
  }
}

配置说明：

  • 'command': 启动 'mcp-google-spreadsheet' 服务器的命令。通常为 'mcp-google-spreadsheet'。如果安装路径不在系统 PATH 中，则需要指定可执行文件的完整路径。
  • 'args': 启动命令的参数列表。本项目不需要额外的启动参数，所以为空数组 '[]'。
  • 'env': 环境变量配置，用于配置 Google API 认证和访问权限：
    • 'MCPGS_CLIENT_SECRET_PATH': 指向从 Google Cloud Console 下载的客户端密钥 JSON 文件 ('client_secret.json') 的路径。这个文件包含了你的 Google API 应用程序的认证信息。
    • 'MCPGS_TOKEN_PATH': 指定用于保存 Google API 令牌的 JSON 文件路径 ('token.json')。首次运行时，程序会自动引导用户完成 OAuth 认证，并将令牌保存在此文件中。后续运行将直接使用保存的令牌，无需再次认证。
    • 'MCPGS_FOLDER_ID': 指定 Google Drive 文件夹的 ID。服务器将限制对该文件夹及其子目录和文件的操作，增强安全性。

获取 Google API 凭据和文件夹 ID 的步骤：

  1. 创建 Google Cloud 项目并启用 API：

    • 访问 Google Cloud Console 并创建一个新的项目。
    • 在项目中启用 Google Drive API 和 Google Sheets API。

  2. 创建 OAuth 客户端 ID：

    • 在 Google Cloud Console 中，导航到 "API 和服务" -> "凭据"。
    • 点击 "创建凭据"，选择 "OAuth 客户端 ID"。
    • 应用类型选择 "桌面应用"。
    • 创建完成后，下载 JSON 格式的客户端密钥文件 ('client_secret.json')，并将其路径配置到 'MCPGS_CLIENT_SECRET_PATH' 环境变量中。

  3. 获取 Google Drive 文件夹 ID：

    • 打开 Google Drive，找到你希望作为根文件夹的文件夹。
    • 文件夹 URL 中 'folders/' 后面的字符串即为文件夹 ID。
    • 将此文件夹 ID 配置到 'MCPGS_FOLDER_ID' 环境变量中。

基本使用方法

  1. 配置环境变量： 根据上述 "服务器配置" 部分的说明，设置 'MCPGS_CLIENT_SECRET_PATH', 'MCPGS_TOKEN_PATH', 和 'MCPGS_FOLDER_ID' 环境变量。
  2. 启动服务器： 在终端中运行 'mcp-google-spreadsheet' 命令启动 MCP 服务器。
  3. 首次运行认证： 首次运行时，程序会自动尝试打开浏览器进行 Google 账号认证。按照提示完成认证流程。如果浏览器没有自动打开，请复制终端中输出的 URL 到浏览器中打开。认证成功后，令牌将自动保存到 'MCPGS_TOKEN_PATH' 指定的文件中。
  4. 在 MCP 客户端中使用： 将上述 "服务器配置" 中的 JSON 配置添加到你的 MCP 客户端（如 Claude、ChatGPT 等）的配置文件中。客户端即可通过 MCP 协议与 'mcp-google-spreadsheet' 服务器通信，并调用其提供的 Google Drive 和 Google Spreadsheet 操作工具。

安全性提示：

  • 请妥善保管 'client_secret.json' 文件，避免泄露。
  • 'MCPGS_FOLDER_ID' 限制了服务器的操作范围，请根据实际需求配置，以降低安全风险。

信息

分类

生产力应用

访问项目